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Preface 


This manual discusses the Philco 2000 Assembler-Compiler, 
TAG. It defines the language of TAC, states the rules which must 
be followed when writing programs in this language, and describes 
the output produced. 

The topics include TAC assembly-control instructions, i.e., 
control instructions to the TAC Assembly Program, as dis¬ 
tinct from TAC Mnemonic instructions discussed in the Philco 
210/211 and the Philco 212 Programming Manuals.. Other topics 
include TAC Constants, Source and Object Program Formats, and 
information necessary for preparing a TAC language program to 
be run on a Philco 2000 computer. 

No previous computer experience, other than a knowlec^e of 
the information presented in the above-mentioned programming 
manuals, is required for an understanding of the information 
presented herein. 
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Introduction 


A TAG ; Compilation The TAG Assembler Program is one of many automatic program¬ 
ming systems that are available with Philco 2000 computers. 
TAG is the basic system; most other programming systems 
translate into the language of TAG. 


The TAG-language program which defines the operations to be 
performed by the computer is the source program. In a TAG 
compilation, the TAG Assembler: 


• assemblies an o6;ecf program in Philco 2000 machine language 
from the source program, 

• compiles library routines into the assembled program, if 
desired, 

• produces a Gode-Edit on tape, listing both the source pro¬ 
gram and the compiled object program (see Ghapter vni), 

o records the object program on tape in the object format 
specified. 

The object format specified may be: 

• Relocatable Binary Gard Format (REL) 

• Absolute Binary Gard Format (ABS) 

• Absolute Binary Tape Format (RPL) 


In an RPL or ABS compilation, all parts of the program (i.e., 
subroutines, separate logical sections, subprograms) are included 
in the compilation. 

In an REL compilation, it is not required that all parts of the 
program be included in the compilation. Separately compiled 
program parts such as binary library subroutines or previously 
compiled subprograms can be included at load time. 

Each object format reflects the use of a particular Loader (see 
Appendix B, Loading Object Programs). 

Subsequent to the compilation, the Gode-Exit is printed off-line; 
binary cards of REL and ABS programs may be punched off-line. 
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A Program Run 


The following diagram shows the relationship between source 
and object programs, and the TAG Assembler. Solid arrows 
(—*•) denote on-line, continuous operation; broken arrows 
(-►.) denote off-line operation. 
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SOURCE PROGRAM 
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In a program run, the object program on tape is loaded into 
memory, then executed. The following diagram depicts this 
process: 
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Chapter 1 


ELEMENTS 
OF THE 
SOURCE 
PROGRAM 


Philco Coding Form and Card Fields. 
Field Elements. Absolute Quantities. 
Symbols. Remarks. 

A TAG source program consists of a series of instructions 
written in TAG-language format. Each instruction is written on a 
line of the Philco coding form (see Figure 1). An instruction or 
statement that is too long to fit on one line may be continued on 
succeeding lines, starting after column 24. 

THE PHILCO The columns of the coding form are divided into fields, as follows, 

CODING FORM corresponding to the fields on the Philco 2000card (see Figure 2). 


Identity and 
Sequence 

1 8 

L 
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Location 

10 16 

G>inmand 

17 24 

Address and Remarks 

25 80 
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Figure 1 ^ A TAC Source Program 
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THE IDENTITY AND 
SEQUENCE FIELD 
(Columnsl-S) 


THE LABEL FIELD (L) 
(Column 9) 


After the program is written, it is punched on cards, each line of 
the codii^ form corresponding to one card. The program is then 
transferred from card to magnetic tape in an off-line operation, 
before being read into the computer for compilation. Durii^ 
compilation, the TAG Assembler assigns a location to each 
mnemonic command, and computes its corresponding address 
field. 
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Figure 2 - Philco 2000 Card 


The identity and sequence field may be: 


• Blank (spaces), or contain 

o Alphanumeric t identity and sequence information, used to 

indicate to the programmer or operator the sequence of the 
source program cards, and to identify the program to which 
these cards belong. 


Information in the field has no effect on the compilation. 


The label field may contain: 

• A blank, or 

• Any of eleven TAG label characters: B, G, D, E, F, I, L, P, 
R, S, or ♦ (asterisk). 


f Any combination of alphabetic and/or numeric characters. 
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Each of these eleven label characters performs a special control 
function, as described below. 


LABEL 

CHARACTER 



Indicates that the program's identity (an alpha¬ 
numeric name identifying the program) is speci¬ 
fied in columns 17-32. The identity is comprised 
of all sixteen characters (spaces included) in these 
columns. 

The "I-Card" must be the first card of the 
program. 


Indicates that the instruction written in the com¬ 
mand and address fields is to be placed in the 
left half of an instruction word. If the previous 
instruction already occupied the left half of the 
word, a NOP instruction will be inserted in the 
right half of the word, and this instruction placed 
in the left half of the succeeding word. 


Indicates that the instruction is to be placed in 
the right half of an instruction word. K the pre¬ 
vious instruction already occupied the right half 
of the word, a NOP instruction will be inserted in 
the left hall of the next word, and the instruction 
placed in the half of this word. 


Indicates that the symbol in the location field ot 
the instruction, or in the address /zeZrfof an ASGN, 
SAME, SYMBOUT, or REFOUT instruction, is a 
common symbol (see page 28). A common symbol 
is a symbol which has a singular definition 
throughout the program. 


Performs the functions of both C and L labels. 


Performs the functions of both C and R labels. 


Indicates the end of the effect of a previous AFEND 
control instruction (see page 16). This character 
is written in the label field of an AFEND instruc¬ 
tion only. 


Indicates that the constant beginmng in the com¬ 
mand field is a Pool Constant (see page 30). 


Indicates that the command and address fields 
contain a TAC subroutine call (see page 41). 


Indicates a FORTRAN subroutine call. See Ap¬ 
pendix C. 


Indicates that this line (card) contains remarks 
only, and has no effect on the compilation. (See 
page 12). 


t For a review of the format of an instruction word, see the Philco 210/211 Programming Manual (TM-10), 
or the Philco 212 Reference Manual {TM*29). 
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THE LOCATION FIELD 
(Columns 10-16) 


THE COMMAND 
FIELD 

(Columns 17-24) 


THE ADDRESS AND 
REMARKS FIELD 
(Columns 25-80) 


The location field is used to tag (assign a symbolic name to) 
an instruction, as a means of referencing that instruction. This 
field may be: 

• Blank, or may contain 

• A symbol* of from 1 to 7 characters. 

If the location field contains a blank, and the command field 
contains a TAG mnemonic, the resulting instruction will be 
assigned the next consecutive available memory location. 

If the location field contains a symbol (tag), all references to this 
symbol will be linked to the corresponding memory location 
assigned to the tagged instruction. 

When used in the location field of a mnemonic, or in the location 
field of a SET, SETLARGE, SETSMALL, ASTOR, or COMSTOR 
control instruction, the symbol is considered defined, and it must 
not appear again in the location field, or appear as a symbol 
(symb) to be defined in the address and remarks field of an ASGN 
or SAME instruction (see page 17), in the same program section. 
If a symbol is doubly defined, the first definition is used and an 
error indication is printed on the Code-Edit. 

The command field is used to specify; 

• A Philco 2000 Mnemonic 

o The command portion of any TAG Control Instruction (see 
Chapter 2) 

• A Constant, as described in Chapter 4 

• Subroutine Calls, Generator Calls, or Macro Calls, as de-r 
scribed in Chapter 5. 

The address and remarks field is used to specify address field 
elements, pool constants (see Chapter 4), and/or remarks. 

An address field element may be: 

• An Absolute Quantity 

• A Symbol, of from 1 to 23 characters 

• A Special Symbol 

o A Compound Symbol 

• An Index-Register Notation 

TAG computes the resultant instruction address from the address 
field elements specified. 


*A symbol is any group of alphanumeric characters with at least 
one character alphabetic. 
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Absolute Quantities 


Symbols 


An absolute quantity is a decimal or octal integer value written 
as follows: 


GENERAL FORMS 

EXAMPLES 

XXXXX 

12345 

Ui/yyyyy 

M/33333 

where xxxxx is a decimal integer of up to 
five digits, and M/ indicates that yyyyy is 
an octal integer of up to five digits. Neither 
xxxxx nor yyyyy exceeds 32,767 decimal. 



A symbol appearing in the address and remarks field may be 
written in either of two forms: 


GENERAL FORMS 

EXAMPLES 

Symb 

Name»Symb 

where Symb represents a symbol of up to 23 
characters in length, and Name is the name of 
a program section (see page 13), 

ALPHA 

PROGRAM.ALPHA 


During compilation, these symbols will be defined (assigned 
a value) by virtue of their appearance in: 

• the location field of a mnemonic, or SET, SETLA.RGE, SET- 
SMALL, ASTOR, or COMSTOR control instruction, or in 

• the address and remarks field of an ASGN or SAME instruc¬ 
tion (see page 19) 

Once a symbol is thus defined, it cannot be redefined. Any 
attempt at redefinition will result in the symbol being doubly 
defined; in which case, the first definition is used, and an error 
indication is printed on the Code-Edit. 

Undefined symbols (symbols not defined as above) in the program 
are defined by the TAC Assembler. These undefined symbols are 
called TEMPORARIES, and are so designated on the Code-Edit. 

Preset symbols such as index-register designations (IX, 2X, etc., 
see page 11) are predefined in the symbol table of TAC, and cannot 
be redefined during a compilation. They can only be changed by 
modifying their assignment in TAC itself. 

A detailed discussion of the Name.Symbol form is discussed 
imder the NAME control instruction, page 13. 
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Special Symbols 


Compound Symbols 


Address Arithmetic 


The notations (P), (PMAX), and wH are special TAG symbols, 
each with a special meaning. These notations are written as 
follows: 


GENERAL FORMS 

EXAMPLES 

(P) 

(P) 

(PMAX) 

(PMAX) 

nH 

7H 

where n is a decimal integer other than zerOa 



The notation (P) refers to the current contents of the Program 
Counter, and represents the location of the current instruc¬ 
tion (i.e., the location of the instruction in which the notation (P) 
appears). 

The notation (PMAX) represents the left address immediately 
following the largest memory address occupied by the program. 

The notation nH refers to half of a location word. It represents 
the half-word relative to (following or preceding) another 
half-word. 

A Compoxmd Symbol is an address field notation that consists 
of two or more absolute quantities, and/or symbols, and/or 
special symbols, separated by arithmetic operators. These 
operators are + (plus), - (minus), * (asterisk), and : (colon), de¬ 
noting addition, subtraction, multiplication, and division, re¬ 
spectively. 

To determine the resxiltant instruction address that the Compound 
Symbol represents, address arithmetic is performed from left 
to right of the Compound Symbol as follows; multiplications and 
divisions first, then additions and subtractions. If the final result 
of the address arithmetic performed is negative, the two’s 
complement of the result is used as the resultant address. 

Example 

Assume the symbols ALPHA and BETA have been assigned the 
values 4000 and 9000 respectively, and the Program Coimter 
currently contains the value 7000. Then, the Compound Symbols; 

ALPHA+50$ 

BETA-ALPHA:2$ 

ALPHA*M/10$ 

(P)+5H$ 

represents the resultant addresses (memory locations) 4050,7000, 
32,000, and the right half of location 7002, respectively. 
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The resultant address computed depends on the object program 
format specified (REL, ABS, or RPL, see pages 51, 60 and 63), 
and must be one of the following: 


1. Absolute 

2. Relative to program origin (the location of the first instruc¬ 
tion of the program) 

3. Relative to the common storage area (see page 83) 

4. Symbolic with an increment* 


A symbol is considered absolute when it is assigned a numeric 
value in an ASGN or SAME instruction (see page 19); it is 
considered relative when defined by TAC in terms of the program 
counter during compilation. 

When REL object format is specified, the following restrictions 
apply: 

• If additions only are to be performed, only one of the 
operands may be relative; all other operands must be 
absolute. 

• If subtractions only are to be performed, the operands can be 
absolute or relative; however, if relative, they must be 
relative to either the common origin or to the program 
origin. 

• If additions and subtractions are to be performed, there must 
be at least n-l relative operands involved in the subtraction 
process for the n relative operands involved in the addition 
process. 

• Multiplication and division are permitted between two operands 
only if both are absolute. 

• No more than one of the operands involved in address arith¬ 
metic may be a REFOUT symbol (see page 23), 

• The result of address arithmetic performed on the address 
in an ASTOR or COMSTOR instruction (see pages 15 and 25) 
must be absolute. 

There are no address arithmetic restrictions with ABS or RPL 
format. 


♦Resulting from a REFOUT instruction, see page 23. 
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Index Register 
Notations 


Address Field 
Termination 


Remarks 


An Index Register Notation is a notation, in the address and 
remarks field, that contains a reference to an Index Register. 
The general forms of Index Register Notations are: 


GENERAL FORMS 

EXAMPLES 


,5 

or 

100,5X 

valfi 

,BETA 

where i is a decimal integer (0-8) or a symbol, 
and the characters represent Index Regis¬ 

ter L 

When i is a decimal integer, an X may be writ¬ 

M/1000, BETA 

ten following it as an alternate way of speci¬ 
fying the Index Register. 

The symbol if present, represents a value 

in the form of an absolute quantity, symbol, 
special symbol, or compound symbol. 



The address formed by TAG has V and N fields of val and i 
respectively. During program execution, the resultant address is 
the sum of the contents of Index Register i and the value val. 

Assuming that Index Register 5 contains the value 2000, and that 
the symbol BETA has been assigned the value 5, the above 
examples refer to memory locations 2000, 2100, 2000, and 2512, 
respectively. 

Address field elements are terminated by a $ character or by 
means of a previous AFEND instruction (see page 16). Where 
necessary, these address elements may be continued into suc¬ 
ceeding address and remarks fields until terminated by a $ 
character or by means of a previous AFEND instruction. 


When address elements continue into the address and remarks 
field of succeeding (continuation) cards, and label, location, and 
command fields must be blank. 

Remarks may be written after the $ character terminating an 
address field element, or after the column specified by a pre¬ 
vious AFEND instruction. (The * label discussed on page 5 is 
also used as an alternate way of writing remarks.) Remarks 
have no effect on the compilation. 






CONTROL 

INSTRUCTIONS 


Chapter 2 


NAME 


Control Instructions To The TAC 
Assembler Progrom, 


Control instructions provide the TAC Assembler with information 
necessary for performing the following control functions: 


• Identify a program or program section (JVAAfE Instruction) 

• Specify the memory size and number of index registers of 
the source computer {IDENTIFY Instruction) 

• Reserve storage locations {ASTOR Instruction) 

• Define the lei^th of the address fields of instructions (AFEND 
Instruction) 

• Alter the program counter (SET,SETSMALL fZxi6.SETLARGE 
Instructions) 

o Define symbols {ASGN or SAME Instruction) 

• Define new instructions, in terms of current acceptable ones 
{DEFINE Instruction) 

• Permit intercommunication between separately compiled 
relocatable object programs {SYMBOUT^L-adREFOUTlasixuc- 
tions) 

® Reserve common storage area for relocatable object pro¬ 
grams {COMSTOR Instruction) 

• Control line and page spacing on the High-Speed Printer 
{SPACE and PAGE Instructions) 

• Reference a subroutine {SUBR Instruction) 

• Indicate the end of a program {END Instruction) 


The function of each control instruction is discussed in detail 
below. The instructions do not affect the flow of operation in the 
program, nor do they (except the SUBR Instruction) introduce 
any additional coding in the object program. 


The NAME instruction is used to identify a program or program 
section (subprogram). This instruction permits TAC to distin¬ 
guish between different program sections making up the complete 
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IDENTIFY 


program, and between identical symbols used in the different 
program sections. The general form of the NAME instruction is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

NAME 

where p is t 
or program 
Program an 
may be one 1 
characters 1 
ter of whicf 

P 

he name of a program 
section (subprogram), 
d subprogram names 
^o eight alphanumeric 
long, the first charac- 
imust be alphabetic. 

NAME 

NAME 

ALPHA 

BETAlOl 


All symbols following a NAME instruction are identifiable by 
the name (p) appearing in that NAME instruction. If the NAME 
instruction is omitted from a program, TAG assumes the name 
NONAME for that program. 


The NAME instruction must be used in cases where a program 
comprises two or more sections. As many as 256 different NAME 
sections may occur in a program. If this amount is exceeded, an 
appropriate error indication is printed on the Code-Edit. 


When an instruction of a subprogram is to be referenced from 
outside the subprogram, the name of the subprogram must 
be prefixed to the location of the instruction referenced. A period 
is used to separate the prefixed subprogram name from the 
location referenced. For example, address DELTA in subprogram 
B must be referred to as address B.DELTA when referenced 
from outside subprogram B. 


The name COMMON has special meaning. Use of this name is 
discussed under Common Symbols, page 28. 


The IDENTIFY instruction is used to indicate to TAC that the 
object computer (the computer on which the object program is 
to be run) differs in memory size and/or in the number of index 
registers from the source computer (the computer on which the 
source program is compiled). 
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The general form of this instruction is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

IDENTIFY 

mK,nX 

IDENTIFY 

32K,8X 



IDENTIFY 

16K 

where m is 8, 16, or 32, indicat¬ 
ing an 8192, 16,384, or 32,768 
word object computer, respec¬ 
tively; and n is an integer* indi¬ 
cating the number of index regis¬ 
ters of the object computer. 

IDENTIFY 

,8X 


The parameters mK and nX are optional; either one may be 
omitted from the DDENTIFY instruction. The parameter mK 
may be omitted if source and object computers have the same 
size memory; the parameter nX may be omitted if both computers 
have the same number of index registers. Where source and 
object computers do differ in memory size and number of index 
registers, the entire IDENTIFY instruction may be omitted from 
the program. 


The ASTOR instruction is used to reserve a specified numbe^ 
of storage locations in memory, outside the area occupied by the 
program. The general form of this instruction is: 


GENERAL FORM 

EXAMPLES 


Location 

Command 

Address 

Location 

Command 

Address 

Symh 

ASTOR 

n 

ARRAY 

BETA 

ASTOR 

ASTOR 

128 

M/7447 

where Symb is a symbol, and n 
is an absolute quantity, or sym- 

KAPPA 

ASTOR 

SIZE 

bol or compound symbol defined 
in the program 

represents the symbolic ad¬ 
dress of the first location of the 
storage area reserved; n repre¬ 
sents the number of storage lo¬ 
cations reserved. 

DELTA 

ASTOR 

N*128-128 


*If the value of n exceeds the computer memory size, the value is 
reduced modulo that size. If address arithmetic is indicated by 
n, the result of the address arithmetic must be absolute. 




14 


TAC ASSEMBLER-COMPILER 


AFEND 


Nullification of the 
AFEND Instruction 


There can be as many ASTOR instructions in a program as 
memory will permit, llie storage locations are reserved con¬ 
tiguously, in the order of appearance of the ASTOR instructions 
in the program. 


The AFEND (Address F'ield END) instruction permits a pro¬ 
grammer to terminate address fields without having to write a 
$ character after each address field. The AFEND specifies where 
the address field of individual instructions end. The general form 
of this instruction is: 


GENERAL FORM 

EXAMPLE 

Command 

Address and Remarks 

Command 

Address and Remarks 

AFEND 

where n \< 
25-80, ind 
the codinc 
each subse 
to be assui 

n$ 

any decimal integer 
icating the column of 

1 form or card where 
quent address field is 
med terminated. 

AFEND 

42$ 


The AFEND instruction causes TAC to assume a dollar sign in 
column n of each subsequent instruction, imtil the AFEND is 
nullified (see below). Remarks may be written after columns 
of the instructions. 


The effect of an AFEND instruction may be temporarily or 
permanently nullified at a subsequent point in the program. 


Temporary nullification occurs for: 

• Any subsequent instruction whose address is terminated 
with a $ character prior to column n of the AFEND. 

• Any subsequent instruction whose address field contains 
a non-space character in column n. Such instructions must 
therefore be terminated by a $ character. 

• Macro or Generator Calls. If remarks are associated with 
a Call, a $ character must precede the remark. 

• Instructions which are included in the program as a result 
of a Subroutine, Macro, or Generator call. An AFEND in the 
main program does not affect such inserted coding. The 
inserted codii^ may contain their own AFEND instructions. 
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Permanent nullification occurs when: 

• A subsequent AFEND instruction specifies a new value for n. 

• A subsequent AFEND instruction with an E in its label field 
is encomitered. The E indicates the End of the effect of the 
previous AFEND instruction. The format of this AFEND is: 

Ij Location Command Address and Re.marks 

E AFEND $ 

The effect of the AFEND instruction on alphanumeric constants 
is discussed on page 34. 


SET The SET instruction is used to set the program counter. By 

means of this instruction the programmer can specify the location 
of any instruction in his program, and can reserve memory 
locations within his program. The general form of this instruction 
is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

SET 

addr 

SET 

512 

where addr 

is any address field 

SET 

M/1000 

element 

except the Symbol 

SET 

BETA 

(PMAX) and Index Register No- 

SET 

(P) + 50 

tat Ions. 


SET 

(P)+BETA 


For REL compilations, the compilation base (initial program 
counter setting) is zero; all relocatable instruction addresses 
are compiled with zero as the base. InABS and RPL compilations, 
TAG assumes the compilation base preset by the installation. This 
base depends on the size of the operation system used, and is 
fixed by the installation*. 

The SET instruction causes the program coimter to be reset to 
the address element specified in its address and remarks field, 
thus changing the address at which the next and succeeding 
instructions are to be placed in the program. For example. 


*K SYS (the Philco 2000 Operatii^ System) is the operating sys¬ 
tem used, the compilation base is 1000 octal. If 32K SYS is the 
operatii^ system, the compilation base is 10,000 octal. 
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SETSMALLand 

SETLARGE 


if the following coding. 


L 

Location 

Command 

Address and Remarks 



NAME 

TRACK$ 


START 

TMD 

ALPHA$ 



SET 

2000$ 


RHO 

TMA 

• 

• 

BETA$ 


appeared in a program, location RHO would be assigned the 
address 2000*. If the program counter read 1500 previously, 
500 locations (words) woiild be skipped over when the SET is 
executed. 

All symbolic address field elements must be defined prior to 
their appearance in a SET instruction. However, symbols defined 
in ASTOR or COMSTOR control instructions must not appear as 
an address field element of a SET instruction. 

These two control instructions perform basically the same 
function as the SET instruction. The SETSMALL instruction 
causes the program counter to be reset to the smaller of the two 
address elements appearing in its address and remarks field; 
the SETLARGE instruction causes the program counter to be 
reset to the larger of the two address elements appearing in its 
address and remarks field. In all other respects, these two 
instructions are similar to the SET instruction. All rules con¬ 
cerning the SET apply. 


The general forms of these two instructions are: 


GENERAL FORMS 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

SETSMALL 

addr^ ,<iddr 2 

SETSMALL 

A+ 1, B + 2 

SETLARGE 

(zddv y ciddr ^ 

SETLARGE 

C, D 

where addr^ and addr 2 are address 
field elements except the symbol 
(PMAX) and Index Register Nota¬ 
tions. 




*In relocatable programs this address is relative to the pro¬ 
gram’s loading origin. 
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ASGN and SAME 


DEFINE 


The ASGN and SAME instructions perform the same function. 
Either ASGN or SAME is used to assign a value to a symbol. 
The value assigned may be absolute or symbolic. The general 
forms of these two instructions are: 


GENERAL FORMS 


EXAMPLES 


Command 

Address and Remarks 

Command 

Address and Remarks 

ASGN 

symb,n 

ASGN 

ALPHA, 2000 

SAME 

symb,n 

ASGN 

ALPHA, M/3720 

where n is 

a value in the form of 

SAME 

BETA, TAU 

an address 

field element (other 

SAME 

BETA, EPSILON+ 50 

than an Index Register Notation), 

ASGN 

A,2000;B,POS;C,M/1500 

and symb is 

a symbol to which the 

SAME 

A, D-40; B, (P) + 50 

value n is assigned. 

Several symbols {symb) may be 
defined by a single ASGN or SAME 
instruction. In this case, each 

ASGN 

NP, M/1051+ 1H 

symb,n' 

combination must be 




separated by semicolons, as fol¬ 
lows: 


ASGN 

SAME 


symij, raj,•57/7162 
577716 jjTij,•5777162 


As indicated in the examples, the parameter n may specify ad¬ 
dress arithmetic; the parameter symb may not. 

A “C” in the label field of an ASGN or SAME instruction makes 
the symbols {symb) in the address and remarks field of the 
instruction cowwcw throughout the program. (See page 28.) 


The DEFINE instruction is used to define or redefine a command. 
The general form of this instruction is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Comm and 

Address and Remarks 

DEFINE 

where symb 
acters long, 
or control i 
digit octal < 

symbfC 

is a symbol 1-8 char- 
, and c IS a command, 
yvord written as a 16- 

:onstant. 

DEFINE 

DEFINE 

DEFINE 

LLD, TMD 

JBT, NOP 

PAUSE, 

0/0000000401150001 
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This instruction causes all subsequent symbols symb in the 
command field to be interpreted as the command or control 
word c. (The repeat mnemonic RPT is a special case, and 
must not appear as either symb or c in a DEFINE instruction.) 
The machine coding produced for symb upon compilation is that 
normally produced for c. 

As indicated in the above examples, the DEFINE instruction 
permits a programmer to: 

1. Define a new command in terms of an existing TAC command. 

2. Redefine one TAC command in terms of another. 


3. Define a computer half-word in terms of a control word 
of the following format: 


BITS 

CONTENTS 

0-16 

A 17-bit mask which is used to insert the S-bit, address 
field, and F-bit into the instruction. If the F-bit is a 
function of the address representation, bit 16 must be 
one. If the F-bit is determined by the mnemonic in bits 
21-28, bit 16 must be zero. 

17-20 

Zeroes. 

21-28 

The command portion of the half-word being defined. 

29 

One or zero: 

A one causes a possible error indication to appear on 
the Code-Edit if the address field of the instruction 
refers to a pool constant. 

30 

One or zero: 

A one causes a possible error indication to appear on 
the Code-Edit if the address field of the instruction 
refers to an index register. 

31 

One or zero: 

A one causes a possible error indication to appear on 
the Code-Edit if the address field does not refer to 
an index register. 

32-33 

Address F-bit indicator. 

00: Indicates that the address of the instruction may 
be a left or right address. 

01: Indicates that the address of the instruction should 
be a left address. 

11: Indicates that the address of the instruction should 
be a right address. 

34 

Zero. 






CONTROL INSTRUCTIONS 


19 


SYMBOUT 


BITS 

CONTENTS 

35 

One or zero: 

A one causes a possible error indication to appear on 
the Code-Edit if the address field of the instruction 
refers to a temporary address, or to the location of 
an ASTOR instruction or a COMSTOR instruction. 

36-37 

00: Indicates that the instruction is either a left or 
right instruction, 

01: Indicates that the instruction is a left instruc¬ 
tion. 

11: Indicates that the instruction is a right instruction. 

38-46 

Zeros. 

47 

One. 


When relocatable programs are loaded together, symbols which 
are defined in one program may reference, or be referenced 
by, instructions in the other programs. To permit such inter¬ 
program referencing, SYMBOUT instructions (and REFOUT 
instructions, see next p^e) identtfyii^ the symbols must be 
included in the programs. 

The SYMBOUT instruction permits TAG to supply the relocatable 
program loader with the definitions of the symbols which appear 
in its address and remarks field. 

The general form of the SYMBOUT instruction is: 


GENERAL FORM 


EXAMPLES 


Command 


Address and Remarks 


Command 


Address and Remarks 


SYMBOUT 


addr 


where addr is a symbol {symb or 
name.symb) that is defined in the 
program containing the SYMBOUT 
and that may be referenced by 
another program. (The element 
symb may be composed of from 1 
to 8 characters.) 


SYMBOUT 

SYMBOUT 

SYMBOUT 


LOOP 

ALPHA.BETA 
RHO; TAU; BETA 


Any number of symbols may be 
specified in the address and re¬ 
marks field of a SYMBOUT in¬ 
struction. If several symbols are 
specified, they must be separated 
by semicolons, as follows: 

SYMBOUT I addr^;addr2; .... 
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REFOUT 


The symbol specified in the address and remarks field of the 
SYMBOUT instruction is defined in the program containing the 
SYMBOUT, and both the symbol and its definition are forwarded 
to the relocatable program loader on SYMBOL DEFINITION 
CARDS, produced during compilation from the SYMBOUT cards 
(see page 58). The REL loader applies the definition to the symbol 
wherever it appears in another program, provided that the symbol 
also appeared in a REFOUT instruction in that program, 

A in the label field of a SYMBOUT instruction causes the 

symbol(s) in the address and remarks field of the instruction to 
be made common throughout the program (see page 28). 


The REFOUT instruction is used in conjunction with the SYMBOUT 
instruction to permit inter-program referencing of symbolic 
locations. 

The REFOUT instruction indicates to TAC that the symbols 
appearing in its address and remarks field are defined in another 
program, and that the definitions of these symbols will be avail¬ 
able to the loader at load time. 

The general form of the REFOUT instruction is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

REFOUT 

addr 

REFOUT 

LOOP 



REFOUT 

ALPHA.SPOT 

where addv is a symbol that is de¬ 
fined in another program, and ap¬ 
pears in a SYMBOUT instruction 
in that program. 

REFOUT 

A.RHO;B.TAU;G.BETA 

Any number of symbols may be 



specified 

in the address and re- 



marks field of a REFOUT instruc- 



tion. If several symbols are speci¬ 
fied, each symbol must be sep¬ 
arated by a semicolon as follows: 



REFOUT 

ciddr jj Old dr •••• 




This instruction causes all references to these symbols to be 
indicated symbolically in the. relocatable binary deck produced 
from the compilation (see page 55). During loading, the relocat¬ 
able program loader obtains from SYMBOL DE FINITION CARDS 
the definitions of these symbols. 
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COMSTOR 


REFOUTs are produced for subroutine calls automatically by TAG. 
(See pages 41 and 43). Any symbol in the program with the same 
name as the called subroutine will automatically be considered a 
REFOUT symbol. 

A “C'* in the label field of a REFOUT instruction causes the 
symbols in the address and remarks field of the instruction to be 
made common throughout the program (see page 28). 


The following example shows the use of the SYMBOUT and 
REFOUT instructions in the two separately compiled programs 
PROGA and PROGB: 


L 

Location 

Command 

Address and Remarks 



NAME 

PROGA 



SYMBOUT 

LOOP $ 


LOOP 

TMA 

ALPHA $ 



END 

% 




• 




NAME 

PROGB 



REFOUT 

PROGA. LOOP $ 



JMP 

PROGA. LOOP $ 



END 

% 


Because the symbol LOOP is defined in program PROGA and not 
in program PROGB in which it is referenced, an appropriate 
SYMBOUT instruction specifying the symbol is included in 
program PROGA, and an appropriate REFOUT inprogram PROGB. 


The COMSTOR instruction is used to reserve a specified number 
of words in memory as a common storage area, to be used by all 
relocatable programs loaded together. 
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The general forna of this instruction is: 


GENERAL FORM 

EXAMPLES 

Location 

Command 

Address 

Location 

Command 

Address 

symb 

COMSTOR 

n 

ALPHA 

COMSTOR 

80 




BETA 

COMSTOR 

500 

where symb is a symbol represent- 




ing the location of the first word 

DELTA 

COMSTOR 

M/700 

of the area reserved, and n is any 




address field element (except a 




Special Symbol or an Index Regis- 




ter Notation) representing the 




number of memory locations that 




are reserved. 






The common storage area is reserved outside the boundaries of 
the program containing the COMSTOR. Tlie location of the area 
reserved is not defined at compilation time but at load time. 
At load time, the first word of common memory reserved is 
made identical for all relocatable programs loaded together. 

There can be as many COMSTOR instructions in a program as 
memory will permit. The total amount of common storage 
specified by a program is equal to the sum of the amoimts of 
storage specified by the individual COMSTORs in the program. 
The COMSTOR areas are reserved contiguously, in the order of 
appearance of the COMSTORs in the program. 

When several relocatable programs are loaded together, the 
amount of common storage reserved will be the largest of the 
total amounts specified for the individual programs. For example, 
if the COMSTOR instructions in the above example represent the 
total amount of storage specified for three separately compiled 
relocatable programs loaded together, a sir^le common storage 
area of 500 words would be reserved for use by all three programs. 

For relocatable programs, the common storage area starts 
immediately after the last word occupied by the operating system. 
At load time all addresses in the common storage area are 
adjusted relative to common origin (the location of the first word 
in this area) by the relocatable program loader. 

Althoi^h the COMSTOR instruction is used primarily in relocat¬ 
able programs, it may also be used in absolute programs. When 
COMSTOR is used in an absolute program, the common storage 
area reserved starts after the last ASTOR area, and the overall 
program size indicated as (PMAX) will reflect the inclusion of 
this area. 
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SPACE rhe SPACE instruction permits the programmer to control the 

vertical spacing of information on the Code-Edit. SPACE causes 
the High-Speed Printer to advance the Code-Edit a specified 
number of lines. The general form of this instruction is: 


GENERAL FORM 

EXAMPLE 

Command 

Address and Remarks 

Command 

Address and Remarks 

SPACE 

n 

SPACE 

10 

where n it 
from 1 to 
number of 1 

> any decimal integer 
32767, indicating the 
ines to be skipped. 




The value n does not include the margins at the top and bottom 
of each Code-Edit page. 

PAGE The PAGE instruction is used to control the amount of informa¬ 

tion to be printed on a page of the Code-Edit. PAGE causes 
the High Speed Printer to advance the Code-Edit to the top of 
the next page. The form of this instruction is: 


GENERAL FORM 

EXAMPLE 

Command 

Address and Remarks 

Command 

Address and Remarks 

PAGE 


PAGE 



SUBR The SUBR instruction is used to call a subroutine. (See also, the 

use of the S label, pages 5 and 41.) This instruction causes TAC 
to include the subroutine specified in the address and remarks 
field of the instruction in the compiled program. The general 
form of this instruction is: 


GENERAL FORM 

EXAMPLE 

Command 

Address and Remarks 

Command 

Address and Remarks 

SUBR 

where nam 
subroutine 

name 

e is the name of the 
that is called. 

SUBR 

XORD 


This instruction does not provide transfer of control to the sub¬ 
routine. The programmer may do this by writing a jump instruc¬ 
tion elsewhere in the program. 
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END The END instruction is used to indicate the end of a program, 

and must be the last physical instruction of the program. 

The general form of this instruction is: 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

END 

addr 

END 

START 



END 

A-EXECUTE 

where addr is an address field 



element (except on Index Register 

END 

BEGIN + 1 

Notation), 

which, if present*. 



represents 

the location to which 



control should be transferred after 



the program is loaded. 




♦When compiling a subroutine for example, addr is omitted 
from the card. (See WRITING A SUBROUTINE, page 43.) 




COMMOK 


Chapter 3 



Use of C Label and Name COMMON 
in Defining Common Symbols. 


If a symbol that is used in different named sections of a program 
is to have the same definition in each section, this common 
definition may be specified by means of the C Label or by means 
of the name COMMON. 


THE C LABEL • A “C” in the label field of an instruction other than an ASGN, 

SAME, SYMBOUT or REFOUT instruction, causes the symbol 
specified in the location field of that instruction to be made 
common^ and to have the same definition wherever it appears 
through the program, regardless of the NAME originally 
associated with it. 


• A in the label field of an ASGN or SAME instruction 

causes each symbol symb in the address field of that in¬ 
struction (see page 19) to be defined as a common symbol, 
regardless of the NAME originally associated with it. 


• A “C** in the label fields of SYMBOUTand REFOUT instruc¬ 
tions causes the symbol(s) appearing in both of these instruc¬ 
tions to be defined as common throughout the program, re¬ 
gardless of the NAME originally associated with it. 


• A “C” in the label field of a NAME instruction causes each 
symbol defined in that named section to have the same 
definition wherever it appears undefined in the other named 
sections of the program. For example, according to the 
coding: 
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L 

Location 

Command 

Address and Remarks 

c 


NAME 

A 



TMD 

ALPHA$ 


BETA 

D/7.5B3$ 




ASGN 

DELTA, 100$ 



NAME 

B 



TMA 

BETA$ 



TMD 

DELTA$ 



• 



THE NAME 
COMMON 


the symbols BETA and DELTA appearing in NAME sections 
A and B will be defined only once. The symbol ALPHA is not 
made common. 

• The name COMMON given to a section of a program causes 
each symbol in that section that is not prefixed with a pro¬ 
gram name to be defined as a common symbol. 

• Tlie name COMMON prefixed to a symbol causes that Symbol 
to be made common throughout the program. 




Chapter 4 


Pool and Non-Pool Constants. 
Full-Word Constants. Field Constants. 
Fixed-Point and Floating-Point Decimal 
Constants* Word and Location Con¬ 
stants. Alphanumeric, Octal, Hexa¬ 
decimal, Numeric, Binary, Parameter, 
and Command Constants. 


POOL AND 
NON-POOL 
CONSTANTS 


A constant is any full word of data, entered with the program, 
that does not vary from compilation to compilation. There are 
eleven different t^es of constants in TAG language. An alpha¬ 
betic or numeric character written preceding the constant and 
separated from it by a slash, specifies the type of constant. During 
compilation, TAG converts each constant to its binary form and 
provides a storage location for it in memory. 

With the exception of alphanmneric non-pool constants (see page 
34), no more than one word of constants may be written per line 
of the coding form. 

Pool constants are constants that are placed by TAG in a 
separate section of the program called the constant pool; non¬ 
pool constants are constants that occupy the memory locations 
assigned to the positions where they appear in the program. 

A constant is interpreted as a pool constant if it is written: 

1. as the address of a mnemonic, or 

2. beginning in the command field, with a P in. the label field. 

Non-pool constants are written starting in the command field, 
with «o p in the label field. 

Some pool constants are conservable (that is, if their binary 
configuration already exists in a word in the pool, it is not dupli¬ 
cated), some are not. 

Gonstants written as the address of a mnemonic are conservable, 
except: 

a. Location Gonstants 

b. Field constants containing a Gommand Gonstant field or a 
Parameter Gonstant field. 
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FULL-WORD AND 
FIELD CONSTANTS 


FULL-WORD 

CONSTANTS 


Fixed-Point 
Constants (D/.) 


A conservable pool constant occurring after another pool constant 
with similar binary configuration will be conserved on the basis 
of the former constant, provided the former constant is also of 
the conservable type, or is of the P-label type other than type (a) 
or (b), above. 

In conserving pool constants, the TAC Assembler searches the 
constant pool to determine whether a binary configuration of the 
constant already exists in the pool. If one exists, its location is 
used and the constant is not repeated. If none exists, TAC inserts 
the constant in the next available word in the pool, and places the 
location of this word in the address field of the mnemonic. 

If the constant is written as a P-label pool constant or as a non¬ 
pool constant, it may be assigned a symbolic location by the pro¬ 
grammer. Note, however, that because of the possibility of con¬ 
servation occurring for a succeeding constant, a “P-labeV* 
constant with a symbolic location field should not be changed 
during program execution. P-label pool constants consecutively 
grouped will be stored in the pool exactly as grouped. 

Some constants occupy a full word of memory, other constants 
may occupy fields or parts of a word. Constants that occupy a 
full word are called full-word constants; constants that occupy 
fields are called field constants. If combined field constants do 
not completely fill a word, the unused bit positions are filled 
with zeros or space symbols, depending upon the type of constant 
that is written. 

Full-word and field constants may be of the pool type or of the 
non-pool t3?pe. 

There are four types of full-word constants in TAC language; 

1. Fixed-point decimal constants 

2. Floating-point decimal constants 

3. Word Constants 

4. Location Constants 

A fixed-point decimal constant is represented by the characters 
D/ followed by any combination of decimal digits, with or without 
a decimal point, not exceeding 140,737,488,355,327. 

A fixed-point constant may be signed (+ or -) or unsigned. If 
imsigned, it is interpreted as positive. A negative fixed-point 
constant is stored in memory in two’s complement form. 

A binary position factor is used to indicate where the binary 
point should be placed in the computer word. The binary position 
factor is written immediately after the constant, and is desig¬ 
nated by the letter B followed by a number (0-47) representing 
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Floating-Point 
Decimal Constants 


Word Constants 
(W/....) 


the least significant bit position of the integral part of the decimal 
constant. If no binary position factor is written, the integral part 
of the constant is scaled B47 and the fractional part (if any) is 
lost. 


Example 


The constant D/1.5B15 would be stored in a word in memory as 
follows: 


0 15 16 47 







Floating-point decimal constants are represented by the charac¬ 
ters F/ followed by any combination of decimal digits, with or 
without the decimal point. A decimal scale factor, En, which 
means ‘'xlOn'', may also be written following the constant. The 
character n may be any decimal integer ejqjonent -600 to 600. A 
binary position factor is not used with a floating-point constant. 

As is the case with fixed-point constants, a positive quantity is 
indicated by no sign or by a plus sign (+), and a negative quantity 
by a minus sign (-). 


Examples 

F/.000024 F/.240E3 F/240.E-4 


Word constants are represented by the characters W/ followed 
by any eight Philco characters (see Appendix D), including the $ 
character. The constant is considered automatically terminated 
after the eighth character. 

The eight characters in the word constant are stored in the order 
in which they are written. For example, the constant 

W/;(TMD)$A 

would be stored as follows: 
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Location Constants 
(L/.....) 


FIELD CONSTANTS 


A location constant is represented by the characters L/ followed 
by an address field element. The address field element is stored 
(in binary) in the address portion of both halves of the word con¬ 
taining the constant. 

K the address field element ALPHA + 2 represents a left address, 
the constant is stored as: 


1516 


23 24 


39 40 


47 


ALPHA +2 


ALPHA +2 


If the address field element represents a right address, an F bit 
of one will appear immediately to the right of the address in both 
halves of the word. 


Field constants, as their name implies, occupy fields or parts of 
a computer word. A Position Factor, Tw, written immediately 
following the constant, indicates where the constant (except 
Alphanumeric and Command constants, see pages 34 and 39) 
terminates in the word. The character « is a decimal integer 
(0-47) specifying the position of the least significant bit of the 
constant. 

When several field constants are made to occupy a word, the 
individual constant designations are written separated by semi¬ 
colons, and the individual position factors, if any, must be in 
ascending order. If a field reserved for a constant is such that 
the high order bits of the constant extends into a preceding con¬ 
stant, or beyond bit position zero, the high order bits are lost. 

If position factors are not specified with the constants, the fields 
fill the word from left to right, in the order in which they are 
written. 


There are seven tjipes of field constants in TAC language: 


Alphanumeric Constants 
Octal Constants 
Hexadecimal Constants 
Numeric Constants 
Binary Constants 
Parameter Constants 
Command Constants 


{No position factor is used.) 

(A position factor may be used.) 
(A position factor may be used.) 
(A position factor must be used.) 
(A position factor may be used.) 
(A position factor must be used.) 
{No position factor is used.) 
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Alphanumeric constants are represented by the characters A/ 
followed by any number of the sixty-four Philco characters 
listed in Appendix D, except the semicolon, dollar sign, and 
the right parenthesis. A semicolon, dollar sign, and in some 
instances a right parenthesis, automatically terminates the 
field. Each character is converted to a unique six-bit code; eight 
such characters occupy a full computer word. 

Alphanumeric constants fill a word from left to right starting 
with the six high-order bits. A termination indicator cannot be 
used to position an alphanumeric field within a word; leading 
zeros may be used for this purpose, if necessary. 

An alphanumeric constant that is written in the address and 
remarks field , may contain eight or less characters, but not 
more than eight. If the constant contains less than eight charac¬ 
ters, and no other field constants are specified to fill the re¬ 
mainder of the word, a $ character must immediately follow the 
last character of the constant. The remainder of the word is filled 
with zeros. 

An alphanumeric constant that is written in the command field 
may contain any number of characters. These characters, if 
necessary, may be continued on succeeding lines of the coding 
form, beginning in the address and remarks field. Each eight- 
character group is placed in a consecutive memory location. If 
the number of characters written is not a multiple of eight, and 
no other field constants are specified to fill the remainder of the 
word, a $ character must immediately follow the last specified 
character. The remainder of the last word is filled with spaces. 

Thus, the alphanumeric constant, 

A/12345678ABCD$ 


written starting in the command field, would occupy two consecu¬ 
tive memory locations as follows: 



1 2 3 4 5 6 7 8 


ABCDAAAA 
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Octal Constants 
(O/.) 


Hexadecimal 
Constants (H/.) 


If an AFEND instruction (see page 16) is used in the program, 
and the alphanumeric constant is not terminated by a $, the 
contents of all columns up to and including the column referred 
to by the AFEND are included in the constant. If the constant 
contains a non-space character in the column (n) referred to by 
the AFEND, the constant must be terminated by a $ character. 

Octal constants are represented by the characters 0/ followed 
by as many as sixteen octal digits (0-7). Each octal digit of the 
constant is converted to three binary bits. A position factor may 
be used to terminate the constant. When no position factor is 
used, the octal constant fills the constant word from left to 
right, startii^ at the Qth bit position. Unused bit positions are 
filled with zeros. 


Example 


The octal constant 0/16T5, 07T4, 0/1600000000000000, or O 16 
would appear as follows: 


0 12 3 45 

47 


Q 

0 0 1 1 10- ' ' 



Hexadecimal constants are represented by the characters H/ 
followed by as many as 12 hexadecimal characters (0-9 and 
A-F). Each character of the constant is converted to four binary 
bits, as shown below: 


HEXADECIMAL CHARACTER 

BINARY EQUIVALENT 

0 

0000 

1 

0001 

2 

00 1 0 

3 

00 1 1 

4 

0100 

5 

0 10 1 

6 

01 10 

7 

0 111 

8 

1 000 

9 

1 001 

A 

10 10 

B 

1 0 11 

C 

1 1 00 

D 

110 1 

E 

1 1 10 

F 

1 1 1 1 
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Numeric Constants 
(N/.) 


Binary Constants 
(n/.) 


A position factor may be used with the constant. When no position 
factor is used, the hexadecimal constant fills the constant word 
from left to right, starting at the 0th bit position. Unused bit 
positions are filled with zeros. 


Example 


The constant H/5AC T23 wovild be stored as follows: 


1112 


23 24 


47 


0 10 1 I 0 I 0 M 00 


Numeric constants are represented by the characters N/ followed 
by an unsigned decimal integer. A position factor must be written 
following the decimal integer or an error will be indicated. 


Example 


The numeric constant N/1149T35 would be stored as follows: 


0 35 36 47 



r\ 




Binary constants are represented by the characters n/ followed 
by some binary configuration. The character n is any decimal 
integer 1 to 48, indicating that the binary configuration specified 
in actually a pattern that is repeated n times in the constant. 

A position factor may be used with the constant. When no position 
factor is used, the binary constant fills the constant word from 
left to right, starting at the 0th bit position. Unused bit positions 
are filled with zeros. 


Example 


The binary constant 5/101T23 would be stored as follows: 


0 8 9 23 24 47 


r\ r\ 

ini ini ini ini ini 



lUl lUI lUI IWI lUI 
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Parameter Constants 

(P/.) 


Command Constants 
(C/.) 


Parameter constants are represented by the characters P/ fol¬ 
lowed by an address field element. W position factor Tn or Fn, 
must be used with this constant, and is separated from the address 
field element specified by a comma. 

When tn is used, the address element without its F-bit is stored 
in the constant word at the position specified by the termination 
indicator n; and unused bit positions are filled with zeros. 


When Fn is used, the address element is terminated at the (n-1)^^ 
bit, and the nth bit will be one or zero, depending on whether the 
address element represents a right or left address, respectively. 
(In relocatable programs, a relocatable address element in a 
Parameter constant must be scaled T15, F16, T39 or F40.) 


Example 


Assume that KAPPA represents a right address that has been 
assigned the value 8, then, the constant P/KAPPA, T39 would be 
stored as: 


P_ 3940_^ 


ri 1 o n n 





The same constant positioned F40 would be stored as follows: 


0 3940 47 



r\ 




The command constant describes half-words of information in 
instruction format. Command constants are represented by the 
characters C/ followed by a Mnemonic and an address field 
element. The address field element is separated from the com¬ 
mand by a comma. No position factor is used with the constant. 

Two command constants, written separated by a semicolon, 
occupy an entire constant word. If only one command constant is 
written, the constant will occupy the left half of the word; the 
right half will be filled with zeros. If another type of field 
constant (positioned before T24) is written precedingthe command 
constant, the command constant will occupy the right half of the 
constant word. 
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Groups of 
Field Constants 


Examples 

The constant C/HLTR,ALPHA; C/JMPL, BETA+1 wouldbe stored 
as: 


0 J5I6 23 24 3940 47 


ALPHA 

10 0 00 000 

BETA+I 

00100000 


The constant 2/101T23; C/HLTL,KAPPA would be stored as; 


0 


2324 


39 40 47 


0 


0 10 1 101 


KAPPA 


0 - 0 


Some typical field constant groups could be: 
N/5T15;C/HLT,ALPHA+5H$ 
l/lT0;O/7T23;A/ABCD$ 

P/ALPHA-BETA, T15; C/HLT,M/5000$ 

H/ABCD;8/1T23;0/7;N/1T47$ 

0/32;A/TYPE0UT$ 

48/1$ 
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Catling and Writing Library Routines. 
Adding Library Routines to the 
Library Tape. TAC Generator Symbols. 
Skeleton Coding. 


general 

DESCRIPTION 


SUBROUTINES 


Calling a 
Subroutine 


Library routines are Subroutines, Generators, and Macros on 
the TAC Library tape. Each routine is an individual program, or 
set of instructions, designed to perform a frequently required 
operation. If the operation to be performed at a point in the 
program can be accomplished by one of these routines, the 
programmer need only reference (call on) the respective routine 
at that point in his program, thus saving valuable coding time 
and effort by not having to code the routine himself. 


A subroutine is a program that operates imder control of a 
calling program, and that is included only once in the calling 
program regardless of the number of times referenced. 

Library subroutines are subroutines on the TAC library tape. 
These may be in TAC-language or in relocatable binary form. 


A subroutine call is used to reference a subroutine. This call 
may be written in either of two forms: 


EXAMPLES 


Location 


Command 


Address 


FLEJ 


ADR1;ADR2; 


GENERAL FORMS 


Location 


Command 


entrance 


Address 


par am 


SUBR 


entrance 


SUBR 


ADR3 

FLEJ 


where entrance is an entrance to 
the subroutine being referenced, 
and param represents the para¬ 
meters of the subroutine. 


Parameters are separated by semi¬ 
colons. If a parameter is repre¬ 
sented by a group of field con¬ 
stants, the parameter must be 
enclosed in parentheses to prevent 
ambiguity in the meaning of the 
semicolons. 
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During compilation, TAG replaces the subroutine call with; 

1. A TMA instruction, to place the first parameter in the Call 
in the A Register, 

2. A TMQ instruction, to place the second parameter in the Call 
ini the Q Register. 

3. TMD and TDM instructions, to place the third and succeeding 
parameters in consecutive memory locations immediately 
following the entrance word. (See Writing A Subroutine, page 

.) 

4. A JMP instruction, to transfer control to the subroutine. The 
SUBR call does not provide for parameter setup as in (1), (2) 
or (3) above, nor for transfer of control to the subroutine. TTie 
programmer may transfer control to the subroutine elsewhere 
in his program. 

During its execution, the subroutine obtains the first parameter 
in the call from the A Register, the second parameter from the 
Q Register, and the third and succeeding parameters from con¬ 
secutive memory locations immediately following the entrance 
word. 

If a parameter will already be in its proper register or memory 
location when the subroutine obtains control, this parameter 
may be omitted from the subroutine call. For example, the follow¬ 
ing calls: 


L 

Location 

G>mmand 

Address and Remarks 

s 


ENTRANl 

;ADR2 $ 

s 

DELTA 

ENTRAN2 

ADR1;;ADR3;;ADR5 $ 

s 


ENTRAN3 

$ 


indicate that the first parameter of subroutine ENTRANl is 
already in the A Register; the second and fourth parameters of 
subroutine ENTRAN2 are in the Q Register and in memory lo¬ 
cation ENTRAN2, ENTRAN2-p2, respectively; and, all parameters 
of subroutine ENTRAN3 are in their proper locations. 

When a parameter is thus omitted from a call, the corresponding 
TMA, TMQ, or TMD and TDM instructions are not generated. 

Subroutines generally store their output values in the same order 
and locations as their parameters (i.e., the first output value in 
the A Register, the second in Q, etc.). Individual output proce¬ 
dures are indicated in the respective subroutine descriptions. 
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Writing a 
Subroutine 


Subroutines may call on generators, macros, or other sub¬ 
routines, which in turn may call on still other subroutines. 
There is no repetition of subroutines in a program; TAG always 
checks to see if a subroutine was previously requested, in which 
case it would already be scheduled for incorporation into the 
program. 


If a section of the calling program has the same name as a sub¬ 
routine being called, the call is assumed satisfied, and the 
library tape is not searched for that subroutine. 


If a called subroutine is not included in the compilation, the 
notice “THE FOLLOWING SUBROUTINES NOT INCLUDED'' is 
printed on the Code-Edit. In an RPL or ABS compilation, this is 
a serious error condition. 


If subroutines are not to be compiled in the program, but are to be 
brought in at load time (in which case both the subroutine and 
the calling program must be in relocatable binary form), refer¬ 
ences to the entrances of the subroutines are automatically com¬ 
piled as REFOUT symbols. 


Most subroutines use Index Registers 1 and 2. The previous 
contents of these registers are not restored by the subroutines; 
the contents of all other Index Registers are saved. 


A subroutine may have several entrances. Each entrance permits 
access to a specific group of instructions that perform a particu¬ 
lar operation. 


The first word of each group of instructions is the entrance word. 
The left instruction in this word establishes the address for 
returning control to the calling program. The right instruction in 
this word provides a transfer of control to the instruction im¬ 
mediately following the last of the words reserved for storing the 
third and succeeding parameters (if any) of the call. The last 
instruction of the group provides an exit from the subroutine by 
transferring control to the half-word immediately following the 
subroutine call. 


An entrance may be left or right; if it involves more than two 
parameters, it must be left. 


*For calls on FORTRAN type subroutines, refer to Appendix C. 
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The following example illustrates the format of a standard TAG 
subroutine: 


L 

Location 

Command 

Address and Remarks 



NAME 

ENTRAN1$ 


L 

ENTRANl 

TJM 

EXIT$ 

First entrance 



JMP 

ALPHA $ 

Locations reserved for 
parameters 


ALPHA 



Beginning instruction of 
group 



JMP 

EXIT$ 

Last instruction of group 

L 

ENTRAN2 

TJM 

EXIT$ 

Second entrance 



JMP 

BETA $ 

Locations reserved for 
parameters 


BETA 



Beginning instruction of 
group 



JMP 

EXIT $ 

Last instruction of group 





Other entrances and 
groups of instructions 


EXIT 

JMP 

ENDSUB 

1SUBERR$ 

$ 

Exit from subroutine 


If the subroutine is to be a TAC-language library subroutine, it 
is added to the library tape as it appears above. If it is to be added 
to the library as a relocatable binary subroutine: 

• the ENDSUB $ instruction is replaced an END $ instruction, 

• the entrances and other symbols of the subroutine that may 
be referred to from outside the subroutine must be defined 
as SYMBOUT symbols and appear in the address and re¬ 
marks field of SYMBOUT cards in the subroutine. Generally, 
a SYMBOUT symbol represents a left address, as this jpre- 
vents the instruction in the calling program that refers to 
this address from being altered at load time. (Refer to F~Bit 
Modifications at Load Time, page 88.) 

• the subroutine is compiled in REL format, and the resultant 
relocatable program deck is added to the librai^r. 
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Adding a 
Subroutine to 
Library Tape 


GENERATORS 


Calling on 
a Generator 


Ibr a description of how to add subroutine to the TAG library, 
the see Program Report 13, PLUM (Program for Library Update and 
Maintenance). 


A Generator is an RPL program on the TAG library tape which, 
when called upon, generates coding to perform a specific oper¬ 
ation. The coding generated depends on the type of generator call, 
and the parameters contained in the call. 


A generator call is used to call on a Generator. The general form 
of this call is; 


GENERAL FORM 

EXAMPLES 

Command 

Address and Remarks 

Command 

Address and Remarks 

Cmnd 

Pl> • • • » Pn 

PRT 

FORMAT 

15;A;B;C$ 

(5E8.2,2F6.3)$ 

where Cmnd is a generator com¬ 
mand (1 to 8 alphanumeric char¬ 
acters long) representing an oper- 

RIT 

10,F200,A(10)$ 

ation to be performed, and each 
p is a symbol representing a 
parameter of the generator. 

The number, order, and format of 
the parameters are established by 
the generator. 




With some generator commands, such as in the second example, 
the complete set of parameters must be enclosed in parentheses. 
Parameters too many to fit on one card may be continued in the 
address and remarks field of succeeding (continuation) cards. 

TAG reserves processing of generator calls until all regular 
TAG instructions (control instructions, nmemonics, etc.) in the 
program are processed, TAG then determines the specific 
generator that is associated with each call, supplies the generator 
with information about the call, and transfers control to the 
generator. The generator processes the call, generates TAG- 
language coding compatible with the type of call and the parameters 
specified, and returns control to TAG. TAG then compiles the 
generated coding into the calling program. 




TAG ASSEMBLER-COMPILER 

TAC reserves a unique 8-character symbol (in location 
EQ2.1GNEW, see page 49) as the address to be assigned to 
the coding generated. If the generator call requires a transfer 
of control to the generated coding, TAC replaces the call with a 
JMP Unique Symbol 

instruction. Whatever was specified in the label and location fields 
of the call would be indicated in similar fields of the JMP instruc¬ 
tion substituted. The generator provides the appropriate linkage 
between the JMP and the generated coding by generating a 
definition for the unique symbol, and by generating an appropriate 
NAME instruction. (The program name that is to appear in the 
generated NAME instruction is supplied to the generator by TAC, 
and is the name of the program section containing the call.) 


K the call does not require transfer of control to the generated 
coding, it is deleted from the program after being processed; no 
JMP instruction is generated. 


The calls are processed in the order indicated by sort numbers 
assigned to the generator commands (Cmnd) when the generator 
is added to the library tape. This permits all the calls of one type 
to be processed before calls of another type. 


After all generators calls in the program have been processed 
by their respective generators, TAC inserts an E AFEND and 
an ENDGEN instruction immediately after the last instruction of 
the generated coding. 


The generated coding appears after the calling program and 
before the area reserved for pool constants on the Code-Edit 
(see page 75). 
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Writing a 
Generator 


The following coding illustrates the general form of a Generator: 


Location 

Command 

Address and Remarks 



1 

ASGN or SAME instruc¬ 
tions permitting com¬ 
munication between TAG 
and the Generator. (See 
page 49.) 


SET 

1GENADD$ 

Establish entry point* 


TJM 

EXIT$ 

Establish exit 


JMP 

EG2.1GNG$ 

Obtain parameters 


* 

1 

Generate coding 


JMP 

• 

J 

EG2.1DUMP$ 

Write out generated cod¬ 
ing 


ASGN 

EXIT,(P)$ 



JMP 

(P)$ 

Return control to TAG 


END 

EG2.ENDGARD$ 



After the generator is selected from tape, it is loaded into 
memory, initialized, then executed. Initialization is performed 
upon a transfer of control to location EG2.EJnDCARD (specified 
in the END card), the starting address of a generator-initializing 
routine in TAG. After initialization, TAG supplies the generator, 
with the following information about the call, and transfers con¬ 
trol to location IGENADD of the generator: 

• The generator command (Cmnd) left justified and with 
trailii^’ spaces, in the A Register. 

• The sort number of the generator command scaled T15 in 
the Q Register. (See Adding A Generator To The Library, 
page 51.) 


♦Address fields of subsequent SET instructions, if any, must 
always contain an address greater than IGENADD. 
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• A unique 8-character symbol in location EG2.1GNEW, to be 
used as the entrance location of the generator coding if, 
during program execution, control is to be transferred to the 
generated coding. 

• The label field of the generator call scaled T5 in location 
EG2.1GLABEL. 

• The location field of the generator call, in location 
EG2.1GFLAD. 

• The program name in effect at the time the call was encoun¬ 
tered, in location EG2.1GNAME. 

• The P-count in binary, scaled T40 in location EG2.1GPCTR, 
corresponding to the point in the program where the call 
occurred. 

The generator processes the above information and: 

• Obtains the contents of the address and remarks field of the 
call from TAG one character* at a time, by transferring 
control each time to location EG2.1GNC. (The character 
obtained appears scaled T5 in both the A and Q Registers, 
after which, control is returned to the generator at the 
instruction following the last executed JMP EG2.1GNC. The 
generator should test for a $ character to determine when no 
more characters in the call remain to be processed.) 

• Generates coding compatible with the type of call and the 
parameters specified. 

• Writes-out the generated coding on tape by transferring 
control to location EG2.1DUMP, with the number of cards to 
be ouiput scaled T15 in the A Register and the starting 
location of the generated coding scaled T29inthe Q Register. 
(After the output cards are written, control is returned to the 
generator at the instruction following the last executed JMP 
EG2.1DUMP.) 

• Returns control to TAC at the instruction immediately 
following the instruction that transferred control to location 
IGENADD of the generator. 

• Either obtains and processes (in the manner indicated above) 
the next call on the generator when control is returned to 
location IGENADD, or generates and writes close-out coding 
if no other call remains to be processed by the generator. 
(The condition of no calls remaining to be processed is indi¬ 
cated by all ones in the A Register at the time TAC returns 
control to location IGENADD.) After producing close-out cod¬ 
ing, if desired, the generator returns control to TAC at the 
instruction following the last executed JMP IGENADD. 

♦Space characters included. If control is transferred to location 

EG2.2GNC instead of EG2.1GNC, space characters are ignored 

and not transferred to the generator. 
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Symbols Permitting 
Communication 
Between TAC and 
Generators 


To permit communication between TAC and the generator, ASGN 
or SAME cards defining the following symbols must be included 
in the generator. In the event of modification of TAC, the symbol 
TACBASE must be redefined. 


SYMBOL 

DEFINITION 

EXPLANATION 

TACBASE 

NTLOADl. TACBASE 

The lowest memory location 
used by TAC itself (i.e., the 
origin of TAC in memory). 

IGENADD 

TACBASE+M/2000 

Location of first executable in¬ 
struction of generator. 

ENDCARD 

TACBASE+M/1016 

Generator end card address. 

IGNAME 

TACBASE+M/1003 

Location containing alphanu¬ 
meric program name in effect 
when call occurred. 

IGNEW 

TACBASE+M/1004 

Location containing TAC- 
created, alphanumeric symbol 
for generated coding. 

IGPCTR 

- 

TACBASE+M/1006 

Location containing, in binary 
form at T40, the TAC pro¬ 
gram (P) count corresponding 
to the point where the call 
occurred. 

IGFLAD 

TACBASE+M/1007 

Location containing, in alpha¬ 
numeric form, the location 
field of the call. 

IGLABEL 

TACBASE+M/1010 

Location containing the label 
field of call, scaled T5. 

IGNC 

TACBASE+M/1011 

Location of a parameter-input 
subrouting in TAC that is avail¬ 
able to generators. 

2GNC 

TACBASE+M/1012 

Location of a second param¬ 
eter-input subroutine in TAC 
that is available to generators. 
Unlike the precedir^ subrou¬ 
tine, this subroutine ignores 
space (blank) characters. 
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SYMBOL 

DEFINITION 

EXPLANATION 

IDUMP 

TACBASE+M/1013 

Location of an output sub¬ 
routine in TAG that is avail¬ 
able to generators. 

When this subroutine is 
entered, the A Register must 
contain the number of cards to 
be output, scaled T15, and the 
Q Register, the starting loca¬ 
tion of the generated coding to 
be output, scaled T39. 

OVERLAY 

TACBASE+M/1014 

Location of a get-next-hlocn- 
on-Ubrary subroutine in TAG 
that is available to generators. 

This subroutine reads the next 
block from the librairy tape 
containing the generator. The 
starting address of the 128- 
word area into which the block 
is to be read must be scaled 
T15 in the A Register at the 
time this subroutine is entered. 

RPLOVER 

TACBASE-t-M/1015 

1 

Location of a get-next-RPL- 
prdgram-on-library subrou¬ 
tine in TAG that is available to 
! generators. 

This subroutine reads the next 
RPL program on the library 
tape containing the generator, 
and transfers control to the 
instruction immediately fol¬ 
lowing the 

JMP EG2.RPLOVER 

1 

Also, the end card of this 
“next RPL” must be 

END EG2.ENDGARD 

to permit TAG to return control 
to the generator properly. 
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Adding a 
Generator to the 
Library Tape 


MACROS 


Calling a Macro 


After the generator program is written, it is compiled in RPL 
format, then added to the TAG library tape. At the time of its 
addition to the library, information about the location and size of 
the generator on tape, the calls it will accept, the order in which 
the calls are to be processed, and which calls require transfer of 
control to the generated coding, must be supplied. 

Procedures for supplying this information when adding a generator 
to the library tape are discussed in detail in Program Report 13, 
PLUM (Program for Library Update and Maintenance). 


A Macro-generator is a program, supplied with the TAG library 
tape, which when called upon by means of a macro-call (macro¬ 
instruction), inserts coding into the calling program. 

The coding inserted consists of a fixed number of instructions, 
and replaces the macro-call in the program. 


A macro-call (macro-instruction) is used to call on the Macro¬ 
generator. The general form of this call is: 


GENERAL FORM 


EXAMPLES 


Command I Address and Remarks 


Command Address and Remarks 


Cmnd 




where Cmnd is a symbol (1 to 8 
alphanumeric characters long) 
specifying an operation to be per¬ 
formed for which coding must be 
inserted into the program, and 
each p is a numeric or alpha¬ 
numeric symbol representing a 
parameter to be used in the in¬ 
serted coding. 

Parameters are separated by 
semicolons. 


RDMTF 

CHKMT 


UNIT;CSA;NBP;NBS$ 
ORDER;INCOMPLETE;| 
ERROR;B$ 


When TAG encounters a macro-call in a program during com¬ 
pilation, it determines from the Table of Contents on the library 
(see PLUM, Program Report 13) the amount of coding that will 
be inserted for the call, and reserves the appropriate space in 
the program for the coding. 
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■Rie coding to be inserted exists in skeleton form (see below) 
following the Macro-generator on tape. TAG transfers control to 
the Macro-generator, which expands the skeleton coding by placing 
the paranaeters of the macro-call in their proper places in the 
skeleton coding, and inserts the ejqianded coding into the calling 
program. 

As many parameters may be specified in a macro-call as are 
provided for in the corresponding skeleton coding. Parameters 
too many to fit on one card may be continued in the address and 
remarks field of succeeding continuation cards. 


Skeleton Coding Numbers and letters assigned to the parameters in the skeleton 

codii^ indicate where each parameter is to be inserted into the 
coding. The parameters are labeled 1 through 9 and A through Z, 
with each number or letter preceded by an equal (=) sign. The 
first parameter is inserted at the point where the =1 characters 
appear in the skeleton coding, the second parameter is inserted 
where the =2 characters appear in the skeleton coding, the tenth 
parameter where the =A characters appear, and so on, imtil the 
skeleton coding is completely expanded and all parameters are 
included. 

The following example is an illustration of a macro-expansion. 
Consider the Macro TLUEQ (Table Look-up for Equality), the 
skeleton coding of this Macro is: 


L 

Location 

Command 

Address and Remarks 



TMD 

l/=3$ 



TDX 

,1X$ 



TMQ 

0/=2$ 



ETA 

=1$ 

R 


RPTAN 

=4$ 



ETD 

1,1X$ 



JAED 

(P)+2H$ 



JMP 

=5$ 



SEXO 

1,1X$ 


For a macro-call of the form: 


L 

Location 

Command 

Address and Remarks 



TLUEQ 

KEY;7777;TABLE;100;ALPHA $ 




LIBRARY ROUTINES 
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Adding Skeleton 
Coding to the 
Library Tape 


the expanded coding will be: 


L 

Location 

Command 

Address and Remarks 



TMD 

L/TABLE$ 



TDX 

,1X$ 



TMQ 

0/7777$ 



ETA 

KEY$ 

R 


RPTAN 

100$ 



ETD 

1,1X$ 



JAED 

(P)+2H$ 



JMP 

ALPHA$ 



SIXO 

1,1X$ 


This expanded coding is inserted in-line into the calling program, 
replacing the macro-call. On the Code-Edit, the expanded coding 
is located after the calling program. 


At the time the TAG-language skeleton coding is added to the 
library tape, information about its Marco-generator, the number 
of locations it will occupy in the program after compilation, and 
whether its first instruction is a left or right instruction, must 
be supplied. 

Procedures for supplying this information when adding skeleton 
coding to the library are presented in Program Report 13, PLUM 
(Program for Libraiy Update and Maintenance). 






Chapter 6 


OBUECT 

PROGRAM 

FORMATS 

Binary Object Program Cards and 
Tape. A Relocatable Binary Deck. 
An Absolute Binary Deck, An RPL 
Object Program Tape. 

As indicated earlier in the Introduction, TAG object programs 
may be compiled in any of three formats: REL, ABS, or RPL. 
Consistent with the format specified, a RELocatable Binary 
Card Deck, an ABSolute Binary Card Deck, or an RPL Absolute 
Binary Program on tape, is produced. 


BINARY OBJECT The format and contents of the object program cards and the RPL 

PROGRAM CARDS object program tape are discussed in this chapter. The manner in 

wMch a loader processes these cards is discussed in Appendix B. 


A RELOCATABLE The binary deck produced on a REL compilation may be depicted 

BINARY DECK as follows: 



Figure 3 — A Relocatable Binary Deck 
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The PMAX Card 


As shown in the preceding figure, each relocatable object deck 
contains the following cards: 

1. PMAX CARD 

2. SYMBOL DEFINITION CARDS 

3. RELOCATABLE BINARY INSTRUCTION CARDS 

4. RELOCATABLE END-PROGRAM CARD 

The formats and functions of these cards are discussed below. 
A 1 indicates a punch, a 0 indicates a blank or non-pimch. 

Except for identify and sequence information in columns 1-8, 
which is in Hollerith code, all other information on the cards 
is in binary. 


The PMAX card is the first card of the object program. It contains 
the program identifier, information as to the length (size) of the 
program, and the amount of common storage required by the 
program. (Program length is the address of the first available 
memory location relative to program origin. It includes the 
amount of storage required by the program, temporaries, ASTOR 
areas, and areas reserved for pool constants.) 

The format of the PMAX card is: 


2 3 4 5 6 7 8 


0 0 0 0 0 0 0 
OOOOOQQ 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 
0 0 0 0 0 0 0 

0 0 0 0 0 0 0 

0 0 0 0 0 0 0 
0 0 0 0 0 0 0 


1 2 3 4 5 6 7 8 |9 IQ 11 12 13 14 15 


9 10 11 12 13 14 15 16 



27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 SB 57 Si 

|o 0 0Eo§<> DOOOOOOOOOOOOOOOOOOOOOOO 
— N 

-'^OOOODOOOOOOOOOOOOOOOOOOOOOI 

ooooooooooooooooooooooooooj 
0 0 ^=^ 0 000000000000000000000000 
0 0 oEo ^0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 I 
0 oEo^O 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o' 



— 


0 0=0^0 0 0 0 0 0 0 0 0 0 0 0 0 0 D 0 0 0 0 0 0 0 0 0 0 0 0 
0 0 — 0^0 0 0 0 00000000000000000000000 
00=OKOOOOOODOOOOOOOOOOOOOOOOOOO 


E^- 


|o 0 OEO^D 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o' 
:0 0 0=0 ^0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
io 0 oEo^O 0000000000000000000000000 


29 30 31 32 33 34 35 36 37 38 39 40 


41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 y 


PHILCO 2000 BINARY CARP 


Figure 4 - Format of the PMAX Card 
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EXPLANATION OF PMAX CARD FORMAT 


LEGEND 


COLUMNS 


ROWS 


CONTENTS 


1-8 


12-9 


Identity and Sequence information, in Hollerith. 


9-12 


12-9 


Punches, or Zero. If zero, card is ignored. If one or 
more of these columns contain pun¬ 
ches, card is processed. 


izzn 


10 


3-9 


1000000 (PMAX Card identification) 




11-12 


12-9 


Checksum* or Zero 


13 

14 


*1 

‘ i, -I 


16 



17-24 


11- 9 

12 - 1 


A binary value. This value is interpreted according to 
the contents of row 9 of column 16. 


An indicator bit: 

0 indicates that columns 13-14 specify the length 
of the object program. 

1 indicates that columns 13-14 specify the loading 
origin of the object program. 


12-9 


Program Identification (96 bits). These bits affect 
checksum only. 


25 

26 


11- 9 

12 - 1 


Number of words of COMMON storage required by the 
program about to be loaded. 


29 

30 



11-2 

12-1 


Number of TEMPORARY and ASTOR locations used by 
the program about to be loaded. 


11- 9 

12 - 1 


Starting address, relative to program origin, of TEMP- 
ORARY/ASTOR area. 


1 or 0. If 1, record is not replaced by record of sub¬ 
sequent temporary/ASTOR area. Next card 
is processed. 


Columns not mentioned above have no effect on loader processing other than their effect 
on the checksum. 


*A sum of all relevant bits on the card, used to check accurate transfer of the informa¬ 
tion on the card. The actual checksum technique is discussed on page 88. 
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Symbol Definition 
Cords 


Symbol Definition Cards provide a loader with the definitions 
of certain symbols used in the object program. These cards 
are produced during compilation from SYMBOUT source cards, 
and are of the following format: 


/ 

1 2 3 4 5 6 7 8 

9 to 11 12 13 14 15 16 

17 18 19 20 21 22 23 24 

25 28 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 j 


00000000 

0 Oi^iD 0^ 


0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 QOOOOQ0 / 

1 

11 




0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

0 




0000000000 Doooooooooooooooooooooool 

1 




ooooooooooooooooooooooooooooooooo/ 

2 

00000000 



00000000000000000000000OOOQOOOOOO( 

3 

QQOOOOOQ 

0 



0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

4 

00000000 




0000000000000000000000000000000000 

5 

00000000 




0000000000000000000000000000000000 

6 

00000000 




000000000000000000000000000000000 / 

7 


1 



0000000000000000000000000000000000 

8 





0000000000000000000000000000000000 

9 





0000000000000000000000000000000000 





25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 5/ 
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Figure 5 -• Format of a Symbol Definition Card 








Additional 

Symbol-Definition First Symbol-Definition Field (Columns 13-24) 

Fields 
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LEGEND COLUMNS ROWS 


11-12 


13 



EXPLANATION OF SYMBOL DEFINITION CARDS FORMAT 


CONTENTS 


10 

3-9 

1-8 

12-9 

9-12 

12-9 


21-24 


25-36 


37-48 


49-60 


61-72 


or more of these columns con¬ 
tain punches, the card is pro¬ 
cessed. 

12-9 Checksum or zero 

12-11 Type of address defining the NAME.SYMBOL which 
appears in column 15: 

00 indicates the address is relative to program 
origin 

10 indicates the address is absolute 

11 indicates the address is relative to common 
origin 

9 An indicator bit: 

0 indicates that the information contained in this 
symbol-definition field is to be processed 

1 indicates that the information contained in this 
symbol-definition field is to be ignored* 

11- 9 Address definition of NAME.SYMBOL. (Row 2 of 

12- 2 column 16 contains the F-bit.) 

12-9 Subprogram NAME associated with SYMBOL. (If 
these columns are blank, this symbol-definition field 
is ignored, and the nesd symbol-definition field is 
processed.) 

12-9 SYMBOL 

Second symbol-definition field.** 

Third symbol-definition field. ** 

Fourth symbol-definition field. ** 

Fifth symbol-definition field. ** 


Columns not mentioned above have no effect on loader processing, other than their 
effect on the checksum. 


* Note the possible use of this feature to have a double definition of a symbol 
ignored. 

**For second, third, fourth, and fifth symbol-definition fields, the format is the same 
as for the first symbol-definition field shown above. 
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Relocatable Binary 
Instruction Cards 


Relocatable Binary Instruction Cards contain the symbols whose 
definitions are to be found on Symbol Definition Cards, source pro¬ 
gram instructions in relocatable binary form, and certain control 
infornoation for a loader. 


The format of these cards is: 


4 

5 

6 


7 


9 


1 2 3 4 5 6 7 8 

9 10 It 12 13 14 15 16| 

7 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 S3 54 55 56 57 58 / 

00000000 


ooc 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 / 


^000000 

00000000 


SSoi - - _ - 

OOOOOOOOOOOOOOOOOOOOOQQOOOQOOOOOQO\ 


%0 0 0 0 0 0 

OOOOQOQO 


^0 0 0 0 0 0 

ooooooQoooooooooooooooooooooooooool 





00000000 


poo 0 0 0 0 

000000000000000900000000000000000 / 

00000000 


Poooooo 

OOOOOOOOOOOQQOQQOOOQOOOOOOOOOOOOO( 

QOOQOOQO 

|[ 


^000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 


1 




00000000 

00000000 

00000000 


Poooooo 

000000000000000000000000000OOOOQ00 

000000000000000000000000000000000 Oi 
000000000000000000000000000000000 / 

ijiH: 

=:=|ftAA|9.‘' 

!oo}n n n n A n 

W 


^0 0 0 Q 0 0 

: 


poooooo 

00000000 

OQQQQQQQ 

00000000 

S:: 


Xw 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o' 

OOOOOOOOOOOOODOOOOOOOOOOOOOOOOOOOO 

0000000000000000000000000000000000 

|i 


^0 0 0 0 0 0 
^0 0 0 0 0 0 

|i 


PoDOOOO 

1 2 3 4 5 6 7 8 

9 10 11 12 13 14 15 16[ 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 46 49 50 51 52 53 54 55 56 57 5/ 


PHILCO 2000 BINARY CARD 


Figure 6 — Format of a Relocatable Binary Instructions Card 
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EXPLANATION OF RELOCATABLE BINARY INSTRUCTIONS CARD FORMAT 





□ 


inAS!U!SiS«AAnAk 



COLUMNS 

ROWS 

CONTENTS 

1-8 

12-9 

Identity and sequence information, in Hollerith. 

9-12 

12-9 

Punches, or zero. If zero, card is ignored. If one or 
more of these columns contain punches, the card is 
processed. 

9 

12-9 

Core Starting Address of first instruction on card. 

10 

12-1 

Row 1 of column 10 is interpreted as the F-bit: 

0 indicates that the first instruction starts in 
column 17. 

1 indicates that the first instruction starts in 
column 19. 

10 

3 

1 (Relocatable Binary Instructions Card Identifi¬ 
cation) 

10 

4-9 

Number (1-32) of instructions on card. 

11-12 

12-9 

Checksum or zero 

13-16 

12-9 

A series of variable length (1-4 bits) indicators, which 
specify the type of address in each instmction; 

0 indicates the address is relative to program 
origin 

10 indicates the address is absolute 

110 indicates the address is relative to common 
origin 

1110 indicates the address references a REFOUT 
symbol 

17-18 

or 

17-26 

12-9 

First instruction on card. 

An instruction usually occupies two columns on the 
card; however, if the address specified in the instruc¬ 
tion references a REFOUT symbol this instruction will 
occupy ten columns on the card. (The last eight columns 
will contain the REFOUT symbol.) 

19-80 

or 

27-80 

12-9 

Additional instructions on card. 












































































58 


TAC ASSEMBLER-COMPILER 


The Relocatable 
End-Program Card 


The Relocatable End-Program Card is produced during compila¬ 
tion from the END card, and is the last card of the relocatable 
binary program deck. This card causes a loader to: 

1. transfer control to the address specified in the END 
card in order to start execution of program, or 

2. commence loading the next relocatable object program. 


The format of this card is: 




“ 





/ 

12 3 4 5 6 7 8 

9 10 11 12 13 14 15 16 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 

r 


00‘ 

' V * “ 


OODOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO/ 

■> 


0 0 

li 

1 


00000000000000000000000000000000001 

■ 


00, 





1 

mam 

0 0> 


iSi 

Ml# 


2 

00000000 

0 0' 

oo[ 


WMM 


3 

00000000 

0 


■ 

1 



4 


1 

B 

.0 0 

1 



5 


B 

H 

00 

i 



6 


1 

1 

B 

1 



7 


D 

B 

.ioo 

1 


|l■l■l■l■l■l|l■l■l■l■l■l■l■l■lll■l■l■l■l■l■l■l■l■l■l■l■lIl|l■ll■lkll1 

8 


I 

[ 

Hi 

i 

vXvX^X 

lilililtlililililililililililililililililililililHililililililililiJ 

9 


s 

9: 


1 


00000000000000000000000000000000001 



a 

rnrnramiBP, 

mmmmm 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 5/ 
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Figure 7 — Format of the Relocatable End^Program Card 
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EXPLANATION OF RELOCATABLE END-PROGRAM CARD FORMAT 

LEGEND 

COLUMNS 

ROWS 

CONTENTS 


1-8 

12-9 

Identity and sequence information, in Hollerith. 


9-12 

12-9 

Punches, or zero. If zero, card is ignored. If one or 
more of these columns contain pun¬ 
ches, the card is processed. 

1 1 

10 

3-9 

1111111 (Relocatable End-Program Card identifica¬ 
tion) 


11-12 

12-9 

Checksum or zero 

1 

13 

12-1 

Indicator bits, specifying the type of address in columns 
15 and 16: 

0000 indicates that the address is relative to pro¬ 
gram origin 

1000 indicates that the address is absolute 

1100 indicates that the address is relative to 
common origin 

1110 indicates that the address references a RE- 
FOUT ‘TSIAME,SYMBOL” 


13 

9 

An indicator bit, which is interpreted follows; 

0 indicates that next program is to be loaded 

1 indicates that after this program is loaded, con¬ 
trol is to be transferred to the jump address 
specified in columns 15 and 16 

1 




15 

16 

11- 9 

12- 2 

An address in the program to which the loader transfers 
control after loading the program. (Row 9 of column 
13 must have been 1.) 




m 

1 

w%«i%vrw 

w!vMvX«M»J 

$vW 


i 

17-24 

12-9 

A NAME.SYMBOL. (Rows 12-1 of colunm 13 must 
have been 1110) 


Columns not mentioned above have no effect on loader processing other than their effect 
on the checksum. 
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AN ABSOLUTE 
BINARY DECK 


The binary deck produced on an ABS compilation may be de¬ 
picted as follows: 



/ TAC \ 


1 LANGUAGE\^ 

PHILCO 2000 

1 SOURCE 
\ PROGRAM 7 

COMPUTER 



ABSOLUTE 

END-PROGRAM 

CARD 




ABS DECK 


ABSOLUTE 

BINARY 

INSTRUCTION 

CARDS 


Figure 8 ^ An Absolute Binary Deck 


As shown in the above figure, each absolute object deck contains 
the following cards: 

1. ABSOLUTE BINARY INSTRUCTION CARDS 

2. ABSOLUTE END-PROGRAM CARD* 

Except for identity and sequence information in Hollerith in 
columns 1-8, all other information on the cards is in binary. 


♦Also referred to as BINARY JUMP CARD 
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Absolute Binary Absolute Binary Instruction Cards contain the source program 

Instruction Cards instructions in absolute binary form, and certain control infornia- 

tion for a loader. The format of this card is: 






1 

/ 

1 2 3 4 5 6 7 8 

9 10 It 12 13 14 IS 16 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 1 

m 

00000000 


00000000 

ooooooooooooooooooooooooooooooooo/ 

11 

00000000 

^ ^0 0 

00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

0 

00000000 


00000000 

oooooooooooooooooooooooDooooooooool 

1 

00000000 

i I'* 

00000000 

000000000000000000000000000000000/ 

2 

00000000 

00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 oooooo( 

3 

00000000 


00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

4 

00000000 


00000000 

0000000000000000000000000000000000 

5 

00000000 


00000000 

0000000000000000000000000000000000 

6 

00000000 


00000000 

000000000000000000000000000000000 / 

7 

00000000 


00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

8 

00000000 


00000000 

0000000000000000000000000000000000 

9 

00000000 


00000000 

00000000000000000000000000000000 ool 


1 2 3 4 5 6 7 8 

9 10 11 12 13 14 15 It 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 5/ 
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Figure 9 - Format of an Absolute Binary Instructions Card 


EXPLANATION OF ABSOLUTE BINARY INSTRUCTIONS CARD FORMAT 

LEGEND 

COLUMNS 

ROWS 

CONTENTS 


1-8 

12-9 

Identity and sequence information, in Hollerith 


9-12 

12-9 

Punches, or zero. If zero, card is ignored. If one or 
more of these columns contain punches, the card is 
processed. 

■ 

9 

10 


Core starting Address of first instruction on card. 

Row 1 of column 10 is interpreted as the Fbit: 

0 indicates that the first instruction is in columns 
13 and 14 

1 indicates that the first instruction is in columns 
15 and 16 

L_□ 

10 

3 

0 (Absolute Binary Instructions Card identification) 


10 

4-9 

Number (1-34) of instructions on card 

iiiiilii 

11-12 

12-9 

Checksum or zero 


13-14 

or 

15-16 

12-9 

First instruction on card 


15-80 

or 

17-80 

12-9 

Additional instructions on card. (Two columns per 
instruction.) 
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The Absolute The Absolute End-Program Card is produced during compilation 

End-Program Card from the END card, and is the last card of an absolute binary 

program deck. This card causes a loader to transfer control 
to an address in the program, prior to the execution of the 
program. 

The format of the Absolute End-Program Card is: 


/ 


_ 



1 

/ 

1 2 3 4 5 6 7 8 

9 10 11 12 13 14 15 16 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 43 49 50 51 52 53 54 55 56 57 58 f 

/n 

00000000 

^0 0 0 0 

00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 / 

11 

00000000 

^0 0 0 0 

00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

0 

00000000 


^0 0 0 0 

00000000 

00000000000000000000000000000000ool 

1 

00000000 


^0 0 0 0 

00000000 

000000000000000000000000000000000 / 

2 

00000000 


^0 0 0 0 

00000000 

00000000000000000000000000000000o( 

3 

00000000 


0 

^000 

00000000 

0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 o\ 

4 

00000000 



^0 0 0 0 

00000000 

0000000000000000000000000000000000 

5 

00000000 



^0 0 0 0 

00000000 

0000000000000000000000000000000000 

6 

00000000 



^0 0 0 0 

00000000 

000000000000000000000000000000000 / 

7 

00000000 



^0 0 0 0 

00000000 

0000000000000000000000000000000000 

8 

00000000 



^0 0 0 0 

00000000 

0000000000000000000000000000000000 

9 

0 0 0 0 0 0 0 0] 

I 

l_ 


^0 0 0 0 

00000000 

0000000000000000000000000000000000 


12345678] 

9 10 11 12 13 14 15 16 

17 18 19 20 21 22 23 24 

25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 5 / 
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Figure 10 — Format of the Absolute End-Program Card 



EXPLANATION OF ABSOLUTE END-PROGRAM CARD FORMAT 

LEGEND 

COLUMNS 

ROWS 

CONTENTS 


1-8 

12-9 

Identity and sequence information, in Hollerith 


9-12 

12-9 

Punches, or zero. If zero, card is ignored. If one or 
more of these columns contain pun¬ 
ches, the card is processed. 

! . • 

9 

12-9 

The address of the first executable instruction in the 


10 

12-1 

program to which a loader transfers control after load¬ 
ing the program. Row 1 of column 10 is interpreted as 
the F-bit. 

i.1 

10 

3-9 

0111111 (Absolute End-Program Card identification) 


11-12 

12-9 

Checksum or zero 


Columns not mentioned above have no effect on loader processing other than their effect 
on the checksum. 
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BINARY OBJECT 
PROGRAM TAPE 


RPL OBJECT 
PROGRAMS 


All object programs (REL, ABS, and RPL) are recorded on the 
Object Program Tape. In the case of REL and ABS programs, 
object decks are subsequently produced; in the case of RPL pro¬ 
grams, no object decks are produced. Except for this latter fact, 
and the fact that no checksum is calcxilated for RPL programs, 
the RPL program is the same as the ABS program. 



Figure 11 — RPL Compilation Output 


Evidence of the similarity between ABS and RPL programs may 
be found, for example, in the number (34) and arrangement of the 
instructions on the cards and on. tape. Also, the RPL instructions 
on tape occur in groups, with as many as 34 instructions per group; 
and, preceding each group is appropriate load information (see 
Figure 12, below). 

The RPL object program on tape includes three types of control 
words produced during compilation: 

1. A PROGRAM IDENTITY control word 

2. A LOAD control word 

3. A TRANSFER control word 

These control words permit a loader to locate the object program 
on the Object Program Tape, to load this object program, and to 
start execution of the program by transferring control to an 
instruction in the program. 


The following figure shows how an RPL program is arranged 
on tape. 



Figure 12 - An RPL Object Program 
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TAC ASSEMBLER-COMPILER 


The PROGRAM 
IDENTITY 
Control Word 


The LOAD 

Control 

Word 


The RPL object program starts at the beginning of a block. 
The first word of the first block is the Program Identity Control 
Word. This control word indicates the number of words following 
it that contain the program's identity. 


0_ 8 9 2324 At 


111010100 




u u 


Bits 0-8 identify this word as the Program Identity Control 
Word. 

Bits 9-23 specify the number (2) of words, following the Program 
Identity Control Word, that contain the RPL program's 
identity. 

Bits 24-47 are ignored. 


A LOAD Control Word precedes each group of instructions of 
the program. This control word indicates the number of full 
words of instructions following it that are to be loaded into 
memory. The format of this word is: 


0 89 232425 39 4041 47 




0 



0 


111111001 

n 

OR 

1 


ADDRESS 

OR 

0-0 





1 



Bits 0-8 identify this word as the Load Control Word. 

Bits 9-24 specify the number («) of full words of instructions, 
following this load control word, that are to be loaded 
into memory. (« represents any number 1-34.) 

Bit 24 specifies whether the number of instructions to be 
loaded is even or odd: 

0 indicates an even number of instructions to be 
loaded 

1 indicates an odd number of instructions to be 
loaded 

Bits 25-39 indicate the starting address where the instruc¬ 
tions in the group following are to be loaded sequent¬ 
ially into memory. 

Bit 40 specifies which half-word is to contain the first 
instruction of the group: 

0 indicates that the first instruction of the group is 
to be loaded into the left-half of the memory 
location specified in bits 25-39. 

1 indicates that the first instruction of the group is 
to be loaded into the right-half of the memory 
location specified in bits 25-39. 

Bits 41-47 are ignored. 
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The TRANSFER 
Control Word 


The last word of an RPL object program is the Transfer Control 
Word. This word causes a loader to transfer control to an instruc¬ 
tion in the program after loading. 

The format of the Transfer Control Word is: 
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24 25 


39 40 


47 


I I I 00000 I 


address 


°\ 

OR 0- 
l| 


Bits 0-8 identify this word as the Transfer Control Word. 
Bits 9-24 are ignored. 


Bits 25-39 indicate the address of the instruction to which con¬ 
trol is to be transferred after the loading function is 
completed. 

Bit 40 is an F-bit specifying the instruction (0: left, 1: right) 
to which control is to be transferred. 


Bits 41-47 are ignored. 





Chapter 7 

MIXED 

INPUT 


Mixed Input. The BITS Input Control 
Card. The TACL Input Control Card, 


RELocatable binary decks may be combined with TAC-language 
source decks to form a mixed input deck. (See Figure 13, below). 
This mixed deck may then be compiled in one of the three object 
formats: REL, ABS, or RPL. 



Figure 13 — A Mixed Input Deck 

To specify the forms (TAC-language or binary) of the respective 
decks, the input control cards TACL and BITS (TACL before 
the TAC-language decks, and BITS before the relocatable binary 
decks) must be included by the programmer. Also, the pre¬ 
compilation card-to-tape operation must be performed in image- 
mode. * 


♦See the Philco 2000 Operating System Manual, TM-23, for a 
definition of image mode. 
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TAG ASSEMBLER-COMPILER 


THE BITS INPUT 
CONTROL CARD 


THE TACL INPUT 
CONTROL CARD 


The BITS input control card is inserted preceding the relocatable 
binary decks of the mixed deck, and it indicates that relocatable 
binary cards follow. The characters BITS are punched in Hollerith 
in columns 9-16 of the card. 

The TACL input control card is inserted preceding the TAC- 
language decks of the mixed deck, and it indicates that TAC- 
language cards follow. The characters TACL are punched in 
Hollerith in columns 9-16 of the card. 



Chapter 8 


THE 


CODE-EDIT 


Contents of the Code-Edit, Source 
and Object Program Listing. Error 
Indications. Generated Remarks. 
Miscellaneous Information, 


CONTENTS OF The Code-Edit is a printed list of the source program, the object 

THE CODE-EDIT program, and other information relevant to the compilation 

process. The source program is shown from I card to END card 
exactly as written by the programmer; the corresponding object 
program is printed in octal adjacent to and following the source 
program. 

The Code-Edit is produced by TAC during compilation, and is 

written on the Edited Output Tape*, then printed off-line. In 

addition to remarks and error notices which may be included to 
aid the programmer in debugging an unsuccessfully compiled 
program, the following information is also printed; 

o Library tapes used 
o REFOUT symbols 

• ASTOR symbols 

« COMSTOR symbols 
o SYMBOUT symbols 

o Called library subroutines that are not included in the 
compilation 

o TEMPORARY symbols 
« Program length 

• Starting location of Pool Constants 

• Amount of common storage 

• Symbol Table 

• Source and Object Programs 

o The coding of called subroutines (if compiled with the 
program) 

o Pool Constants 

A Code-Edit of the sample program in Figure 1 is shown below. 
This program was compiled in RELocatable format; if it were 
compiled in ABS or RPL format, information such as SYMBOUTS 
and REFOUTS would be irrelevant, and the notice SUBROUTINES 
NOT INCLUDED would constitute a serious error condition. 


*Also referred to as the Code-Edit Tape. 
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'If no librories ore used in the compilation process, the words "NO LIBRARIES USED" ore printed, 


TAG ASSEMBLER-COMPILER 












The Symbol Table lists the definitions of all symbols 
(alphanumericolly sorted) encountered during the compi¬ 
lation process. 


f^ame .Symbol 



code; edit of sample program 


PAGE 2 


symbol table 


A00003L 

common 

.ISUBERR 

P00014L 

SAMPLE 

.1T0G02 

aooooil 

common 

.IX 

A00002L 

COMMON 

.ZX 

A00Q04L 

common 

.4X 

A00005L 

COMMON 

.&x 

A0Q007L 

COMMON 

.7X 

AOOOOOL 

COMMON 

.8X 

P00037L 

Sample 

.COEFF 

POOOOOL 

sample 

.EXECUTE 

P00003R 

sample 

.LOOP 

A0Q144L 

SAMPLE 

.N 

P00027R 

PIOSGEN 

.RETURN 

P0003QL 

PIOSGEN 

.SAVE 

P00204L 

COMMON 

.(PMAX) 





e 







Address Type Indicator*, specified for each holf-word: 

P means address in instruction is relative to program 
origin. 

C means address in instruction is relative to common 
origin. 

A means address is obsolute. 

S indicates some part of the oddress specified is a 
REFOUT. {Definition of this part will be 
made at load time, and appears during 
compilation as zero on the Code-Edit.) 


The instruction (mnemonic ond oddress) in octal. 


Address field of instruction, in octal**. 


Mnemonic (reflecting F-bit setting).- 


Octal location of instruction. 


Coding generated to properly load parameter of subroutine 
FLOGIOX, and to transfer control to the subroutine. 


Macro-instruction. 


JUMP instruction inserted for PRT generator call requiring 
transfer of control to generoted coding. 


Generator call not requiring transfer of control to gen¬ 
erated coding. 


Remork generated by TAC. 


Object program coding corresponding to POLYVAL Mocro- 
instruction call. 


I Object progrom coding corresponding to PRT generator c 


Object program coding corresponding to POSITION gen¬ 
erator call. 


Non-Pool constant corresponding to word (w/) constant 
generated for FORMAT generator call. (Note that con¬ 
stants occupy entire words, and that two Address Type 
Indicators are specified for each constant-one per half¬ 
word.) 


Object Progr om, in octol. } 



A T indicates that some part of the address specified is 
a TEMPORARY. 


TAM 

JMPL 


JMPL 

JMPL 


00031 00014423 

00000*05 64000061 
00000 00000003 

00145 10062413 

00000*05 64000022 
00001*05 64000743 
00145*05 64062477 

*05 64000021 
00000040 
*05 64000024 
00015023 
.05 64000474 
00000003 

00017024 
00006040 

00021 00010440 

00005 00002440 


Source Program, expanded skeleton coding, ond generated 
coding, in TAC-language. 


CODE EDIT OF SAMPLE PROGRAM 


SAmPOOIO 

SAMP0020 

SAHP0030 

SAMP0040 

SAMP0050 

SAMP0060 

SAMP0070 

SAMPOO0O 

SAMP0090 

SAmPOIOO 

SAmPOIIO 

SAMP0120 


SAMPLE program 

PROGRAM TO EVALUATE A POLYNOMIAL 
NAME samples 

COEFF A5T0R N*1S 

ASGN N.IOOS 

EXECUTETMD L/C0EFF$ 

TOXLC .5* 

RPTNA N*l$ 

TMQ 0*5S 

FMMRS 1*5S 

SIXO N*1.5$ 

FLOGIOX ,5S 


S LOOP 


COEFF IS STARTING LOCATION FOR COEFFICIENTS 

define degree of polynomial 


CALCULATE coefficients 


SAMP0130 

SAMP0140 

SAMP0150 


TAM 

tmd 

AiXj 


C/HLT»C0EFF*N*1;c/HLT.LOOPS 
1,5S 


SAMP0160 
P T SAMP017Q 
P SAmPOIBO 
SAMP0190 
SAMP0200 
SAmP021Q 
SAHP022Q 


POLYVAL ARGjniCOEFFS 
TAM VALUE S 

PRT F,value S 

FORMAT <9H1VALUE ■ . 
POSITIONS 
JMP M/5$ 

END EXECUTE S 


WITH argument In arg*evaluate polynomial 
PRINT VALUE OF POLYNOMIAL 

ei7,5)S 


*>>>»>>»>>>>>>>>>>»>>»>>>>>>>>>>>»>»>>>>>>>end card jump address is poooool 










NAME 

SAMPLE $ 

00014L 








SET 

M/00006 S 

“00006R 

TMD 

00 033 

00015423 

P 

POlYOOOI 

R 


TMD 

l/coeff*i$ 

{I0007L 

tdxl 

00000*01 

44000060 

A 

POLY0002 



TDX 

«1XS 

00007R 

THA 

00037 

00017421 

P 

polyooos 



TMA 

COEFrS 

OOOIOL 

TMQ 

00035 

00016422 

P 

T POLYO004 



TMQ 

AHGS 

OOOIOR 

RPTNA 

00144 

10062013 

A 

polyooos 

R 


RPTNA 

NS 

OOOllL 

FMAR 

00000 

00000352 

A 

POUY0006 



FMAR 

S 

JJOOllR 

FAH 

00001*01 

44000700 

A 

POLY0007 



FAM 

l*lXf 






polyooob 



endmacro 







E 


AFENDS^ 










NAME 

sample $ 

/00014L 

TJMH 

00027 

00013610 

P 



1T0002 

TJM 

PIOSgEN.returns 

00014R 

TMQ 

00034 

00016022 

P 




TMQ 

H/8T19 |P/F,T39S 

1 00015L 

txdlc 

00000*01 

44000063 

A 




txdlc 

.IS 

\00015R 

TXDfiC 

00000*02 

50000263 

A 




txdrc 

.2S 

/00016L 

TDM 

00030 

00014034 

P 




TDM 

PiOSGEN,SAVES 

S00016R 

JMPL 

0 0000 

00000040 

S 




JMP 

lOH.IOMQUTS 

io0017L 

TMA 

00036 

00017021 

P 

T 



TMA 

VALUES 

f 00017R 

JMPL 

00000 

00000040 

s 




JMP 

ioh,iocnv$ 

00020L 

JMPL 

000 0 0 

00000040 

s 




JMP 

lOH.rILLS 

\00020R 

JMPL 

00026 

00013040 

P 




JMP 

PIOSgEN.RESTORES 

|00G21L 

TJML 

0D022 

00011010 

p 



1T0004 

TJM 

(P)+1S 

\00021R 

JMPL 

00000 

00000040 

s 




JMP 

IOHTaB,RUNALL» 

•(00022L 

JMPL 

00022 

00011040 

p 




JMP 

<P>S 

J00Q22R 

NOPL 

00000 

00000003 

A 






(00023 

7411 

3001 6521 

4364 

AA 



F 

W/{9H1VALU S ■ 


. Expanded Skeleton Ceding inserted in-line to satisfy 
’ POLYVAL Macro call. 


-TAC generated instruction. 


' Coding generated for PRT generator call. 


> Coding generated for POSITION generator call. 

First of series of coding generated for FORMAT generator 


TO 


* Included only if program is relocatable. 

**Both V and N fields, if an index register is specified. 


TAC ASSEMBLER-COMPILER 










Pool Constants and their locations. 


If subroutines ore compiled with the program, the sub¬ 
routines will appear in object program form immediate!/ 
preceding the Pool Constants. 


o 


0 

o 

o 

o 

e 


12-18 11-31,6 


CODE EDIT OF SAMPLE PROGRAM 



00024 

2560 

1360 7325 

0107 

AA 

M/Ex, 

E17 


00025 

3305 

3460 6060 

6060 

AA 

M/f 5) 


0 






NAME 

piosgens 


00026L 

TMD 

0 0030 

00014023 

P 

restoretmd 

piosgen.i 


00026R 

TDXLC 

00000*01 

44000061 

A 

tuxlc 

*1$ 

o 

00027L 

TDXRC 

00000*02 

50000261 

A 

tdxrc 

.2S 


00027R 

JHPR 

00027 

00013640 

P 

RETURN JMP 

(P)S 


00030 

0000 

0000 0000 

0000 

AA 

SAVE 


o 






SUBR 

IONS 







subr 

iohtabs 







E AFENDS 


o 






ENDGENS 



— 00031 

0001 

7400 0001 

7400 

PP 

00032 0010 2000 0000 

1600 

e 

00034 

0000 

0200 0001 

1400 

AP 




I Remainder of coding generated for FORMAT generator call. 

;s 1 

> Close-out coding generated by Generator. 

ITAC generated instructions. 

00033 0002 0000 0002 0000 PP 



THE CODE-EDIT 
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TAC ASSEMBLER-COMPILER 


ERROR 

INDICATIONS 


Serious Errors 


If an. error is encountered in the source program during compila¬ 
tion, an appropriate error indication is printed following the 
erroneous instructions or constant on the code-edit, and compila¬ 
tion continues. Serious error indications are preceded by minus 
signs; possible error indications* are preceded by asterisks. 

The following is a list of serious error indications that may be 
printed on the code-edit. 


SERIOUS ERRORS 


---------- .ADDRESS FIELD ERROR 

.ADDRESS OF NEXT INSTRUCTION CYCLES MEMORY 

--------- - AMBIGUOUS OR CONFLICTING F BITS 

____________ -BINARY CARD‘‘nnnnnnnn’^ BAD 

_______________ COMMAND FIELD ERROR 

.- CONTROL CARD ADDRESS FIELD ERROR 

.CSA OF BINARY CARD IMPROPER, USED ZERO 

---- --------- - - - DOUBLE ASSIGNMENT 

DOUBLE ASSIGNMENT WOULD OCCUR IF SYMBOL WERE COMMON 

.___ end card address error 

________ _ illegal constant on PREVIOUS CARD 

- ---- .ILLEGAL CONTINUATION CARD 

.IMPROPER REFERENCE TO AN INDEX REGISTER 

--------------- - LABEL FIELD ERROR 

.__- location field error 

.NAME FIELD ERROR, NONAME USED 

.P/ CONSTANT NOT PROPERLY POSITIONED 

.- PROGRAM CYCLES MEMORY 

.- SET PARAMETER NOT PREVIOUSLY DEFINED 

._ ____ SYMBOL TABLE OVERFLOW 

.TOO MANY NAMES, NONAME USED 

______________ '‘xxxxxxxx^^ NOT DEFINED 

.-.212 COMMAND IN 211 PROGRAM 


♦Indications of minor errors which are due to unusual coding 
techniques, but may have been intended by the programmer. 
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Possible Errors The following is a list of possible error indications that may be 

printed on the code-edit: 


POSSIBLE ERRORS 


♦ ♦**♦*******=1=******* ADDRESS FIELD OVERLAP 

♦ ♦♦♦***♦*:(:***** field overlap previous constant 

♦ ♦si!************** improper index register field 

**********+*♦*****♦♦*** IMPROPER LABEL 

*♦*****♦*******♦♦***♦ index field omission 

%♦♦♦♦*****♦ NO DOLLAR SIGN (AS THE END SYMBOL OF A LINE) 

♦ ♦*:(:♦***♦♦***♦**♦♦♦ numeric field too large 

%♦*♦*♦*♦**♦♦ POSSIBLE ERROR REFERENCE TO A CONSTANT 

♦ * * * POSSIBLE ERROR REFERENCE TO TEMPORARY, ASTOR OR COMSTOR 
%* ♦*♦****♦♦**♦♦****** POSSIBLE F-BIT ERROR 
*:i^*******4 REFERENCE TO COMMON STORAGE MADE ABSOLUTE 

Hc****Hc>t:********=t= refout address is index modified 

:(:*****=(:♦**♦♦** RELOCATABLE ADDRESS MADE ABSOLUTE 
******* TOO MANY FRACTIONAL CHARACTERS PREVIOUS CONSTANT 


GENERATED In addition to the error indications discussed above, any of the 

REMARKS following three remarks about the END card may also be included 

on the code-edit by TAC: 

>>>>>>>>>>>> NO ADDRESS IN END CARD 
>>>>>>>>>>>>>> REFOUT IN END CARD 
>>>>>>>> END CARD JUMP ADDRESS IS xxxxxxxx 

Appendix A lists other comments, accompanying the Code-Edit, 
that are typed out on the Console Typewriter by TAC during 
compilation. 






Appendix A 


TYPEWRITER 

TYPE-OUTS 


Operating System Typeouts of Source 
Program Errors, Tape and Other 
Errors Encountered During Compilation. 


During the compilation process, one or more of the following 
notices are tj^ed out on the Console Typewriter by the TAC 
Assembler. 


TYPEOUT 

MEANING 

SUGGESTED RECOVERY 

ACTION 

ID IS XX. . .XX 

Program Identity is xx. . .xx 


TAPE n NOT AV 

Tape unit identified as n is not 
available. Computer halts with 
M/11111 displayed in its Pro¬ 
gram Register. 

Make tape available and press 
ADVANCE to continue. 

TAPE « NO LIB 

The tape mounted on Tape Unit 
n was not a library tape. 

Mount correct library tape and 
press ADVANCE to continue. 

BAD LIB TAPE n 
IGNORED 

An illegal control word was en- 
comitered in the Table of Con¬ 
tents of the library tape now on 
tape n. 

None. TAC continues assem¬ 
bling, ignoring the rest of the 
Table of Contents o| that li¬ 
brary tape. 

BAD RPL 

A missing control word was 
detected in a called Generator 
or Macro-generator program. 
Computer halts with M/77777 
displayed in the Program Reg¬ 
ister. 

None. 

TAPE n IN LOCAL 

Tape unit n is in local status. 
Computer halts with M/11111 
displayed in the Program Reg¬ 
ister, 

Make tape available and press 
ADVANCE to continue. 
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TAC ASSEMBLER-COMPILER 


TYPEOUT 

MEANING 

TAPE n WR RING 

Tape imit n is missing a write 
ring. Computer halts with M/ 
mil displayed in the Program 
Register. 

TAPE n ROCKED 

5 

A Parity or Sprocket error was 
detected on tape n. Program 
tried to correct error five 
times and failed. Computer 
halts with M/lllll displayed in 
the Program Register. 

TAPE n NO GOOD 

Non-recoverable tape error 
detected on tape Program 

GEN ERR 

A Generator requested more 
parameters than were supplied 
in its generator call by the 
programmer. TAC assumes the 
call to be satisfied and pro¬ 
ceeds with the compilation. 

1 DMP TAC 
or 

.2 DMP TAC 

A TAC Assembler Program 
error. Computer halts with M/ 
77777 displayed in the Program 
Register. 

T n X CARDS y 
BLOCKS 

This typeout occurs at the end 
of compilation if the object pro¬ 
gram is in REL or ABS format. 

It tells the number (x) of cards 
of information transferred to 
the Object Program Tape, n, 
and the number of blocks on 
this tape that contains this 
transferred information. (Card 
output blocks are always in 
image mode, 20 words per 
card, 6 cards per block. The 
last block is filled with blanks.) 

RPL BLOCKS y 

This typeout indicates the num¬ 
ber of blocks (y) the RPL ob¬ 
ject program comprises on 
tape. 


SUGGESTED RECOVERY 
ACTION 


Make tape available and press 
ADVANCE to continue. 


Press ADVANCE to attempt to 
correct error five more 
times, or change tape and re¬ 
start job. 


Change tape n and restart 
job. 


Check generator or generator 
call. 


Get post-mortem dumps and 
call Philco's Programming 
Department. 



























Appendix B 


LOADING 


PROGRAMS 


Typical REL, ABS, and RPL Program. 
Loaders. Processing of Object Program 
Cards and Tape. Address Modifica¬ 
tions. F-Bit Modifications. Checksum. 


This appendix briefly describes the loading functions performed 
by typical TAG loader programs. 

During compilation, a binary object program is produced on tape, 
together with information necessary for a loader to properly load 
this object program. The loader may be a RELocatable program 
loader, an ABSolute program loader, or an RPL program loader, 
depending on whether REL, ABS, or RPL object program format 
was specified. 


THE RELOCATABLE R is not necessary in a REL compilation for every individual 

PROGRAM LOADER program section, such as a binary library subroutine or a 

previously compiled subprogram, tobe included in the compilation. 
At load time, the separately compiled programs or program 
sections can be loaded together by the REL loader to form an 
integrated program. All the necessary linkage or intercommuni¬ 
cation between the respective programs is achieved by the loader 
from information on SYMBOL DEFINITION CARDS (see page 58), 
and RELOCATABLE INSTRUCTION CARDS (see page 60), which 
are produced during compilation from SYMBOUT and REFOUT 
source cards respectively (see pages 22 and 23). 

The loading origin for relocatable programs is a variable which 
depends on the program size and the amount of available memory 
locations. The loading origin of a relocatable program is calcu¬ 
lated by the Relocatable Program Loader, by subtracting the 
length of the program, which is supplied on a PMAX card by TAC 
(see page 56),' from the address of the last available memory 
location. For example, if a REL program requires 4000 memory 
locations, and the amotmt of available memory is 32,768 locations, 
then, the program's loading origin would be location 28,768 
(i.e., 32,768 - 4000). 

If the address definition assigned to the symbol ALPHA during 
compilation is 2000, ALPHA will refer to location 30,768 (i.e., 
2000 locations relative to 28,768). 
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TAG ASSEMBLER-COMPILER 


REL Object programs are loaded in a forward direction (in order 
of increasing location) at the end of memory. The first object 
program is loaded in such a way that the last location of the 
program occupies the last memory location; the second object 
program is loaded so that its last location occupies the location 
immediately preceding the location occupied by the first location 
of the first program, and so on. (Refer to Figure 14, below.) 


REL PROGRAMS 



Figure 14 — Loading of Relocatable Object Programs 


For REL programs, the common storage area starts immediately 
after the last memory location occupied by the operating 
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REL LOADER 
PROCESSING OF 
OBJECT PROGRAM 
CARDS 

Processing Done 
For All Cards 


Address 

Modifications 


system.* The length of this area will be the largest of the common 
storage requirements indicated on the individual PMAX cards. 

An error check is made by the REL loader to insure that no 
relocatable program overlaps the common storage area. It adjusts 
all addresses relative to the common origin or relative to a 
program origin. 

After all the respective binary card decks representing the 
individually compiled program sections are loaded, the REL loader 
checks for remaining undefined symbols (REFOUTs). If undefined 
symbols exist, the loader searches the TAG binary relocatable 
library tape for the subroutines containing definitions on SYM¬ 
BOL DEFINITION CARDS for these REFOUT symbols. These 
subroutines are then loaded. If undefined symbols still exist after 
the library search is completed, an appropriate error notice is 
given and the loader transfers control to the operating system. 

The REL loader processes every object program card. The 
manner in which the information on these cards (shown in the 
format explanation charts in Chapters) is processed is described 
below. 

® Columns 1-8 of each card are ignored. These columns contain 
Identity and Sequence information in Hollerith, and have no 
effect on loader processing. 

® Columns 9-12 of each card are checked to determine if they 
contain punches. If these columns contain no punches, the 
card is ignored. 

* If one or more of columns 9-12 contain punches, row 3 or 
rows 3-9 of column 10 are checked for card identification. 
If these rows are not punched, loader processing halts and 
control is returned to an error routine in the operating 
system. 

o Columns 11 and 12 of each card contain a checksum for that 
card. If this checksum and that computed by the loader do not 
agree, loader processing halts and control is returned to an 
error routine in the operating system.** 

If columns 11 and 12 are blank, no checksum is computed for 
the card. 

The Relocatable Program Loader adjusts all relative addresses 
appearing on the SYMBOL DEFINITION CARDS, the RELO¬ 
CATABLE BINARY INSTRUCTION CARDS; and the RELOCAT¬ 
ABLE END-PROGRAM CARD. Absolute addresses are not 
modified. 


* If SYS (the Philco 2000 Operating System) is the operating 
system used, the last memory location occupied by the 
operatii^ system is 777 octal. If 32K SYS is the operating 
system used, the last memory location occupied by the 
operatii^ system is 7,777 octal. 

** Refer to the checksum technique discussed on page 88. 
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Processing The 
PMAX Card 


Processing Symbol 
Definition Cards 


In addition to the processing indicated on page 81, which is done 
for all object program cards, thePMAXcardis further processed 
by the loader as follows: 

• The loader determines the loading origin for the object 
program from the contents of columns 13, 14, and 16: 

If row 9 of column 16 is pxmched (one), the address 
specified in columns 13 and 14 is the loading origin 
of the object program. 

If row 9 of column 16 is not punched (zero), the informa¬ 
tion contained in columns 13 and 14 is subtracted from 
the address of the last available memory location, and 
this difference becomes the loading origin of the object 
program. 

• The loader establishes the origin of the common storage 
area as that location immediately following the last location 
occupied by the operating system, and adjusts all common 
addresses, specified by the contents of columns 25 and 26 of 
the PMAX card, relative to this common origin. 

• After processing the information in the other columns of the 
PMAX card, the loader checks to insure that available 
memory is not exceeded, and no overlap of the common 
storage area occurs. If memory is exceeded or an overlap 
occurs, loading is terminated, an appropriate error indica¬ 
tion is typed by the console typewriter, and a post-mortem 
dump is performed. 

The loader constructs a list of the symbols whose definitions are 
found on SYMBOL DEFINITION CARDS. This symbol list occupies 
the area that was assigned to ASTORS, TEMPORARIES, and 
common storage at compile time. The loader inserts the defini¬ 
tions specified in these cards into the symbol list as follows: 


• If the symbol is not already in the list, it is placed in the list 
with its definition. 

• If the symbol is already in the list, and is xmdefined (that is, 
it is placed in the list because of a previously encountered 
REFOUT on a RELOCATABLE INSTRUCTIONS CARD OR 
RELOCATABLE END-PROGRAM CARD), its definition is 
placed in the list, and each address, on the previously en¬ 
countered RELOCATABLE INSTRUCTIONS and RELOCAT¬ 
ABLE END-PROGRAM cards, that contains a reference 
to the symbol is replaced with the sum of the definition of 
the symlwl and the compiled definition of the address. 

• If the symbol is already defined in the list, a “double defini¬ 
tion" error notice is typed on the Console Typewriter, and 
the first definition specified is used. 
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Processing 
Relocatable Binary 
Instruction Cards 


Processing The 
Relocatable 
End-Program Card 


In processing a RELOCATABLE BINARY INSTRUCTION CARD, 
the Relocatable Program Loader adjusts the definitions of the 
addresses on the card relative to program origin or to common 
origin, according to the indicator bits in colunms 13-16 of the 
card. No adjustment is made for absolute addresses. 


If the address references a REFOUT symbol, the loader: 

o Adds the REFOUT symbol to the symbol list if it is not 
already in the list, or 


• If the symbol and its definition is already in the list (derived 
from the symbol's appearance on a previously encountered 
SYMBOL DEFINITION CARD), the loader obtains its defini¬ 
tion from the list, and replaces the address referencing that 
symbol with the sum of the definition of the symbol and the 
compiled definition of the address. 


If an address element was specified in the address and remarks 
field of the END source card, the resulting RELOCATABLE END- 
PROGRAM CARD will cause the loader to transfer control to this 
address after loading the program. Before transferring control, 
however, the loader: 


• Adjusts the address in columns 15 and 16 of the card accord¬ 
ing to the indicator bits in column 13, in the same manner as 
described above in processing RELOCATABLE BINARY 
INSTRUCTION CARDS. 


• Checks its list for any remaining imdefined symbols (RE- 
FOUTs). If no undefined symbols remain, control is trans¬ 
ferred to the address in the End-Program Card. 

If undefined symbols remain, the loader searches the TAC 
relocatable binary library tope for subroutines containing 
defintions on SYMBOL DEFINITION CARDS for these REFOUT 
symbols. The loader then loads these subroutines and trans¬ 
fers control to the address in the End-Program Card. 

If xmdefined symbols still exist after the library search is 
completed, an appropriate error notice is given, and the 
loader transfers control to the operatii^ system. 

If no address element was specified on the END source card, the 
loader will attempt to load the next program directly after loading 
this program. 
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F-Bif A/Vodifications 
At Load Time 


Checksum Performed 
by The Loader 


In order to have an instruction that contains a REFOUT symbol 
refer to the proper half of the address represented by that symbol, 
the relocatable program loader may modify the F-bit of the 
instruction by adding zero or one (corresponding to the address 
being left or right, respectively) to the F-bit. For example, if 
the symbol ENTRANl represents a right address in a called 
subroutine, and the instruction TDM in a calling program refers 
to this address, TDM will be changed to SCD at load time. 

The loader computes the checksum for an object program card 
by summing all the relevant data bits on the card, and compares 
this computed checksum with the checksum value existing in 
columns 11 and 12 of the card. H these two columns are blank, 
no checksum is computed. 

The checksum values will agree when data on the card has 
been transferred accurately. If these values do not agree, loader 
processing halts, and control is returned to an error routine 
in the operating system. 

The following coding shows the checksum procedure; assume 
that symbolic index register CARD is set to the address of 
a word containing columns 1-4 of the card beii^ checksummed: 


L 

Location 

Command 


Addres 

»s and Remarks 



TJM 

CKSUMX 

$ 




CD 


$ 




TXDLC 

0,CARD 

$ 




TDM 

CARDLOC 

$ 




TMQ 

2, CARD 

$ 

TEST FOR COLUMNS 



ETA 

24/1T47 

$ 

11-12 BLANK 



JAZ 

CKSUMX 

$ 




ETA 

24/1T23 

$ 

COLUMNS 9-10 TO A- 



CQ 


$ 

JLj 



SRAQ 

1 

$ 




AIXOL 

3, CARD 

$ 

SET TO COLUMN 13 

R 

VARRPT 

RPTAN 

(0) 

$ 

PRESET BY CARD 






TYPE 



AMA 

1,CARD 

$ 




SRAQ 

1 

$ 




AQA 


$ 




TAD 


$ 




SCD 

24 

$ 




AD 


$ 




SRA 

24 

$ 




TMD 

CARDLOC 

$ 




TDXLC 

0,CARD 

$ 

RESET TO COLUMN 1 



TMQ 

24/1T47 

$ 

COMPARE WITH 



ES 

2,CARD 

$ 

CHECKSUM ON CARD 


CKSUMX 

JAZ 

CKSUMX 

$ 

CHECKSUMS AGREE 



JMP 

EiRRORB 

$ 

NO AGREEMENT 
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Because the number of columns to be summed depends on the 
card type, the symbol VARRPT in the above coding should be 
assigned; 

• the value 17iov PMAX, SYMBOL DE FINITION, and RELOCAT¬ 
ABLE END-PROGRAM cards 

• the value 0 for ABSOLUTE END-PROGRAM cards 

• the symbol Y for RELOCATABLE and ABSOLUTE BINARY 
INSTRUCTION CARDS. The symbol Y is defined as the 
integer part of the quantity (a:+^+ 1), where 


_ Number of instructions on card specified in row s 4-9 of column 10 

2 

and k = 1/2 or 1, depending on whether the F-bit in row 
1 - column 10 of the card is zero or one, respectively. 

THE ABS AND RPL The loading origin for absolute programs is the compilation base. 
PROGRAM LOADERS ABS and RPL programs are loaded in a forward direction, starting 

at the compilation base. 

The common storage area may be located anywhere in memory. 
The ABS or RPL loader does not keep a record of common stor¬ 
age, not checks for memory overlap. 

The following figure shows the loading scheme for ABS and RPL 
programs. 


ABS a RPL PROGRAMS 



Figure 15 — Loading of Absolute Object Programs 
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ABS LOADER 
PROCESSING OF 
OBJECT PROGRAM 
CARDS 


The ABS loader processes every object program card? The in¬ 
formation in colunms 1-12 of these cards are processed in the 
same manner as for Relocatable Program Cards, indicated on page 
85. No address modifications are performed. 


ABS Loader Processing 
of Absolute Binary 
Instruction Cards 


In processing an Absolute Binary Instructions Card, the ABS 
loader loads the instructions appearing on the card consecutively 
into memory, accordii^ to the Core Starting Address specified 
in columns 9 and 10 of the caird. 


ABS Loader Processing 
of The Absolute 
End Program Card 


The address indicated in columns 9 and 10 of the Absolute End- 
Program Card is the address originally specified in the address 
field of the END source card, and it is to this address that the 
loader transfers control subsequent to loading the program. 
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CALLS ON 

FORTRAN SUBROUTINES 

The F label is used for calls on FORTRAN t3rpe subroutines. 
It is currently a feature of the 32KSYS version of TAG* only. 

The general form of this call is: 


L Location Command Addess and Remarks 

Y symb entrance paramparam . . . ; par am $ 

where symb represents and optional symbol, and each param is 
a parameter of the subroutine. 

The format of the call on a FORTRAN subroutine is similar to 
that on a standard TAG subroutine (see page 37) except that: 

• F in the label field signifies a call on a FORTRAN subroutine. 

• None of the parameters may be omitted from the call. 

The resultant in-line coding generated for the FORTRAN sub¬ 
routine call is: 

JMP entrance .entrance^ 

NOP parami% 

NOP param2$ 


NOP paramrf^ 

The symbol in the location field, if any, is assigned to the loca¬ 
tion of the generated JMP instruction. Because FORTRAN sub¬ 
routines expect transfer of control to have come from a right hand 
instruction, the JP instruction is always made to occupy the right 
half of the word as if an R had been written in its label field. 

A NOP instruction is generated for each parameter. The address 
field of the NOP is the address of the parameter. 


*The version of TAG that is designed to operate under control of 
the Philco Operating System, 32KSYS. 
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Appendix D 


TABLE OF 
PHILCO 


PHILCO 

OCTAL 

HOLLERITH 

CHARACTER 

CODE 

PUNCH 


40 

11 or 8-4 (T) 

j 

41 

11-1 

K 

42 

11-2 

L 

43 

11-3 

M 

44 

11-4 

N 

45 

11-5 

O 

46 

11-6 

P 

47 

11-7 

Q 

50 

11-8 

R 

51 

11-9 

•n. 

52 

11-8-2 (T) 

$ 

53 

11-8-3 

♦ 

54 

11-8-4 

< 

55 

11-8-5 ® 

# 

56 

11-8-6 (D 

LJ 

57 

11-8-7 0 

Blank (space) 

60 

Blank 

/ 

61 

0-1 

S 

62 

0-2 

T 

63 

0-3 

U 

64 

0-4 

V 

65 

0-5 

W 

66 

0-6 

X 

67 

0-7 

Y 

70 

0-8 

Z 

71 

0-9 

1 

72 

0-8-2 0 

9 

73 

0-8-3 

( 

74 

0-8-4 


75 

0-8-5 0 


76 

0-8-6 0 

e (D 

77 

0-8-7 0 


PHILCO 

OCTAL 

HOLLERITH 

CHARACTER 

CODE 

PUNCH 

0 

00 

0 

1 


1 

2 

02 

2 

3 

03 

3 

4 

04 

4 

5 

05 

5 

6 

06 

6 

7 

07 

7 

8 

10 

8 

9 

11 

9 

@ 

12 

8-2 0 

= 

13 

8-3 

9 

14 

8-4 


15 

8-5 0 

& 

16 

8-6 0 

T 

17 

8-7 

+ 

20 

12 

A 

21 

12-1 

B 

22 

12-2 

C 

23 

12-3 

D 

24 

12-4 

E 

25 

12-5 

F 

26 

12-6 

G 

27 

12-7 

H 

30 

12-8 

I 

31 

12-9 

n 0 

32 

12-8-2 0 

• 

33 

12-8-3 

) 

34 

12-8-4 

% 

35 

12-8-5 0 

? 

36 

12-8-6 0 

ft 

37 

12-8-7 0 


(T) Multiple punched. 


@ These two characters are not acceptable TAG characters, and are included 
here only to show the complete character codes. 
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Appendix E 


TAC 

MNEMONICS 


The following TAC mnemonics are currently acceptable to the TAC Assembler. 


MNEMONICS 

AD 

DORMS 

FMA 

JAGQFR 

MMAR 

SRD 

ADXL 

DR 

FMAA 

JAGQL 

MMARS 

SRDN 

ADXR 


FMAAR 

JAGQR 

MMAS 

SRQ 

ADCJ 

EA 

FMAARS 

JANL 

MMR 

SRQN 

ADCJEG 

El 

FMAAS 

JANR 

MMRS 

SWD 

AKJS 

EIS 

FMAD 

JAPL 

MMS 


ADCOL 

ENDDP 

FMAR 

JAPR 

MSU 

TAD 

AIXOR 

ES 

FMARS 

JAZL 


TAM 

AM 

ETA 

FMAS 

JAZR 

NOPL 

TAQ 

AMA 

ETD 

FMM 

JBTL 

NOPR 

TCM 

AMAS 

ETX 

FMMA 

JBTR 


TCXS 

AMS 


FMAAR 

JDPL 

RPT 

TCXZ 

AQ 

FAD 

FMAARS 

JDPR 


TDA 

AQA 

FAM 

FMAAS 

JL 

SCD 

TDC 

AQAS 

FAMA 

FMMR 

JMPL 

SD 

TDM 

AQS 

FAMAS 

FMMRS 

JMPR 

SDXL 

TDQ 

AWCS 

FAMS 

FMMS 

JNOL 

SDXR 

TDXL 


FAQ 

FMSU 

JNOR 

SETDP 

TDXLC 

CA 

FAQA 

FSD 

JOFL 

SDCJ 

TDXLY 

CAM 

FAQAS 

FSM 

JOFR 

SIXJES 

TDXR 

CAMA 

FAQS 

FSMA 

JQEL 

srxjG 

TDXRC 

CAMAS 

FCAM 

FSMAS 

JQER 

SIXOL 

TDXRY 

CAMS 

CAQ 

FCAMA 

fcAmas 

FSMS 

FSQ 

JQNL 

JQNR 

srxoR 

SKC 


CAQA 

FCAMS 

FSQA 

JQOL 

SKF 

TIXS 

CAQAS 

FCAQ 

FSQAS 

JQOR 

SLA 

Trxz 

CAQS 

FCAQA 

FSQS 

JQPL 

SLAN 

TJML 

CD 

FCAQAS 


JQPR 

SLAQ 

TJMR 

CM 

FCAQS 

HLTL 

JR 

SLAQN 

TMA 

CQ 

FCSM 

HLTR 


SLQ 

TMD 

CSM 

FCSMA 


LWD 

SLQN 

TMQ 

CSMA 

FCSMAS 

ICOS 


SM 

TQA 

CSMAS 

FCSMS 

ICOZ 

MA 

SMA 

TQD 

CSMS 

FCSQ 

mCAL 

MAA 

SMAS 

TQM 

CSQ 

FCSQA 

mCAR 

MAAR 

SMS 

TTD 

CSQA 

FCSQAS 


MAARS 

SQ 

TXDL 

CSQAS 

FCSQS 

JAEDL 

MAAS 

SQA 

TXDLC 

CSQS 

FDA 

JAEDR 

MAD 

SQAS 

TXDLY 


FDAQ 

JAEQL 

MAR 

SQS 

TXDR 

DA 

FDAQS 

JAEQR 

MARS 

SRA 

TXDRC 

DAQ 

FDAS 

JAGDL 

MAS 

SRAN 

TXDRY 

DAOS 

FEA 

JAGDR 

MM 

SRAQ 

TYXS 

DAS 

FES 

JAGQFL 

MMA 

SRAQN 

TYXZ 
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Appendix F 

SUMMARY 
LIST OF 
TAC CONTROL 
INSTRUCTIONS 


This appendix provides a convenient reference to all TAC control instructions discussed 
in the manual. 


INSTRUCTIONS 

Page 

Reference 

Command 

Address and Remarks 

AFEND 

n 

14 

ASGN 

symb, n 

17 

ASTOR 

n 

13 

COMSTOR 

n 

21 

DEFINE 

symb, c 

17 

END 

addr 

24 

IDENTIFY 

mk,nX 

12 

NAME • 

P 

11 

PAGE 


23 

REFOUT 

addr 

20 

SAME 

symb,n 

17 

SET 

addr 

15 

SETLARGE 

addraddr^ 

16 

SETSMALL 

addr , addr 

JL ^ 

16 

SPACE 

n 

23 

SUBR 

name 

23 

SYMBOUT 

addr 

19 
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